Garage¶

Monte um bucket em um cluster Garage — armazenamento S3 leve e autogerenciado — como uma unidade do Windows.

Antes de começar¶

Prepare o seguinte com antecedência:

A URL do ponto de extremidade S3 do seu cluster Garage.
Um par ID da Chave de Acesso e Chave de Acesso Secreta com acesso concedido ao bucket de destino.
A região configurada para o cluster (o padrão do Garage é garage).

Onde obter as chaves — na máquina que administra o cluster:

garage key create raidrive-key
garage bucket allow --read --write YOUR-BUCKET --key raidrive-key

O primeiro comando exibe o Key ID e a Secret key.

Ajuda do Garage

Clique em Adicionar na barra de ferramentas.
Escolha Enterprise → Garage.
Informe a URL do ponto de extremidade, a região, o ID da Chave de Acesso e a Chave de Acesso Secreta, e clique no botão Atualizar ao lado do campo de bucket.
Selecione o bucket e clique em Conectar.

Entrada manual de bucket

Se sua chave não tiver permissão para listar buckets, marque a caixa de seleção à esquerda do campo de bucket e digite o nome do bucket diretamente.

Configuração	Descrição	Padrão
Ponto de extremidade	URL da API S3 do Garage	—
Região	Valor de região do cluster (necessário para assinatura de solicitações)	—
ID da Chave de Acesso / Chave de Acesso Secreta	Par de chaves do Garage	—
Bucket	O bucket a montar (lista ou entrada manual)	—
Somente leitura	Bloqueia gravações na unidade montada	desativado

As conexões usam endereçamento no estilo path-style, e certificados TLS privados ou autoassinados são aceitos — adequado para implantações em LAN e homelab.

Sintoma	Causa	Correção
Erros de assinatura	A região não corresponde à configuração do cluster	Defina o campo Região com o valor `s3_region` do cluster
Lista de buckets vazia	A chave não tem acesso concedido no bucket	Conceda acesso à chave com `garage bucket allow`, ou digite o bucket manualmente