Garage¶

Monte um bucket de um cluster Garage — armazenamento S3 leve alojado por si — como unidade do Windows.

Antes de começar¶

Prepare antecipadamente o seguinte:

O URL do endpoint S3 do seu cluster Garage.
Um par ID da chave de acesso e Chave de acesso secreta com acesso ao bucket pretendido.
A região configurada para o cluster (a predefiniçã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 apresenta o Key ID e a Secret key.

Ajuda do Garage

Ligar¶

Clique em Adicionar na barra de ferramentas.
Escolha Enterprise → Garage.
Introduza o URL do endpoint em Ponto final, a Região, o ID da chave de acesso e a Chave de acesso secreta e, em seguida, clique no botão Atualizar junto ao campo do bucket.
Selecione o Bucket e clique em Conectar.

Introdução manual do bucket

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

Definições¶

Definição	Descrição	Predefinição
Ponto final	URL da API S3 do Garage	—
Região	Valor da região do cluster (necessário para assinar os pedidos)	—
ID da chave de acesso / Chave de acesso secreta	Par de chaves do Garage	—
Bucket	O bucket a montar (lista ou introdução manual)	—
Somente leitura	Bloqueia a escrita na unidade montada	desativado

Comportamento e limites¶

As ligações utilizam endereçamento em estilo de caminho (path-style) e são aceites certificados TLS privados ou autoassinados — adequado para implementações em LAN e homelab.

Resolução de problemas¶

Sintoma	Causa	Soluçã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 ao bucket	Execute `garage bucket allow` para a chave, ou escreva o bucket manualmente