Guias

Gestor de ficheiros para DigitalOcean Spaces: ligue-o ao Nubbo

Como ligar um bucket do DigitalOcean Spaces ao Nubbo: a access key, a região, o assistente passo a passo, a regra CORS e o que fazer se falhar.

O Nubbo liga-se ao DigitalOcean Spaces com uma access key do Spaces e a região dos seus buckets. Em poucos minutos tem os buckets num explorador de ficheiros com carregamentos diretos, ligações de partilha e galerias. Este guia segue passo a passo o assistente do Nubbo, com os dois caminhos: automático ou com uma chave limitada a um bucket.

O que consegue

  • Explorar o bucket como se fosse um disco: pastas, vistas, pesquisa, lixo, etiquetas e favoritos.
  • Carregar e transferir ficheiros diretamente entre o seu navegador e o DigitalOcean Spaces. Os ficheiros nunca passam pelos servidores do Nubbo.
  • Partilhar ficheiros e pastas com palavra-passe, expiração e limite de transferências, receber ficheiros no seu bucket e criar galerias.
  • As suas chaves são guardadas encriptadas com AES-256-GCM e pode desligar o bucket a qualquer momento.

Antes de começar

Precisa de uma conta no DigitalOcean Spaces e de uma conta no Nubbo. Cada bucket que liga conta para o limite do seu plano: o Grátis permite 2, o Personal 5 e o Pro não tem limite. O Spaces está disponível em 13 regiões: nyc3, ams3, sfo2, sfo3, sgp1, lon1, fra1, tor1, blr1, syd1, atl1, ric1 e mkc1. O Nubbo pede a região porque cada uma tem o seu próprio endpoint.

Escolha como ligar

O assistente do Nubbo oferece dois caminhos. Ambos terminam da mesma forma: o bucket ligado e pronto para carregamentos a partir do navegador.

AutomáticoCom uma chave limitada
ChaveAcesso a toda a contaLimitada a um bucket
BucketO Nubbo usa um dos seus ou cria um novoCria-o você primeiro
CORSO Nubbo adiciona a regra por siAdiciona você a regra
Quando o escolherA forma mais rápidaQuando não quer dar acesso a toda a conta

Ligação automática

Passo 1: crie a chave no DigitalOcean Spaces

  1. No painel de controlo da DigitalOcean, abra Spaces Object Storage e vá ao separador Access Keys.
  2. Prima Create Access Key, escolha Full access e dê-lhe um nome, por exemplo nubbo.
  3. Copie a access key e a secret. A DigitalOcean só mostra a secret uma vez.

Passo 2: ligue o bucket no Nubbo

  1. No Nubbo, abra Buckets e prima Ligar bucket. Escolha DigitalOcean Spaces e prima Continuar.

    Passo Fornecedor do assistente do Nubbo com DigitalOcean Spaces selecionado Passo Fornecedor do assistente do Nubbo com DigitalOcean Spaces selecionado
  2. Escolha Automático e prima Continuar.

    Passo Como ligar com as opções Automático e Com uma chave limitada Passo Como ligar com as opções Automático e Com uma chave limitada
  3. No passo A sua chave, cole a access key e a secret e escolha a região dos seus buckets. Prima Verificar chave. O Nubbo verifica que a chave funciona e que tem acesso a toda a conta.

    Passo A sua chave para DigitalOcean Spaces com o guia rápido e os campos da chave Passo A sua chave para DigitalOcean Spaces com o guia rápido e os campos da chave
  4. Escolha um dos seus buckets e prima Usar este bucket, ou selecione Criar um novo, escreva um nome (e escolha a região, se for pedida) e prima Criar e preparar. O Nubbo adiciona ao bucket uma regra CORS que só permite carregamentos e transferências a partir da app e mantém as regras que já existiam.

    Passo O seu bucket com a lista de buckets e a opção Criar um novo Passo O seu bucket com a lista de buckets e a opção Criar um novo
  5. Reveja as três verificações, altere o Nome no Nubbo se quiser e prima Concluir. O bucket aparece em Buckets e pode abri-lo no explorador.

    Passo Concluído com as verificações da ligação, do bucket e do CORS Passo Concluído com as verificações da ligação, do bucket e do CORS

Se o Nubbo não conseguir adicionar a regra CORS com a sua chave, o assistente leva-o ao passo CORS. Siga então a secção Adicione a regra CORS.

Ligação com uma chave limitada

Passo 1: prepare o bucket e a chave no DigitalOcean Spaces

  1. Em Spaces Object Storage, prima Create Bucket, escolha a região e um nome e crie o bucket.
  2. Em Access Keys, prima Create Access Key e escolha Limited access.
  3. Escolha o seu bucket com a permissão Read/Write/Delete, dê um nome à chave e crie-a.
  4. Copie a access key e a secret. As chaves limitadas não funcionam em buckets que tenham uma bucket policy.

Passo 2: ligue o bucket no Nubbo

  1. Em Buckets, prima Ligar bucket, escolha DigitalOcean Spaces e depois Com uma chave limitada.
  2. Cole a access key e a secret e escolha a região. Prima Verificar chave.
  3. Escreva o nome exato do bucket e prima Verificar acesso.
  4. O assistente passa ao passo CORS com a regra que tem de adicionar.

Adicione a regra CORS

A regra CORS permite que o navegador carregue e transfira ficheiros do seu bucket em https://nubbo.app. É a mesma regra que o assistente mostra no passo CORS.

  1. Em Spaces Object Storage, abra o bucket e vá a Settings.
  2. Em CORS Configurations, prima Add.
  3. Preencha o formulário com estes valores e prima Save CORS Configuration.
Origin: https://nubbo.app
Allowed Methods: GET, PUT, POST, DELETE, HEAD
Allowed Headers: *
Access Control Max Age: 3600

Com uma chave limitada tem de a adicionar você: na DigitalOcean, alterar o CORS através da API exige uma chave com Full access.

Passo CORS com a regra a adicionar ao bucket Passo CORS com a regra a adicionar ao bucket

Depois de a guardar, volte ao Nubbo e prima Já a adicionei, verificar. Alguns fornecedores demoram um minuto a aplicá-la. Se a sua chave tiver permissão para alterar o CORS, Tentar configurá-lo por mim faz isso por si.

Se algo correr mal

Mensagem no NubboO que fazer
“Credenciais inválidas. Verifique a chave de acesso e a chave de acesso secreta.”Copie novamente as duas chaves, sem espaços no início nem no fim.
“Esta chave parece limitada a um bucket. Pode continuar pelo caminho limitado ou criar uma chave com acesso total.”Prima Continuar com chave limitada, ou crie uma chave com acesso a toda a conta e prima Experimentar outra chave.
“Bucket não encontrado. Verifique o nome e a região.”Confirme o nome exato do bucket e que a região escolhida é a do bucket.
“A sua chave não tem permissão para criar buckets.”Use uma chave com acesso total, ou crie o bucket no seu painel e prima Já o criei no meu painel.
“Esse nome já está em uso neste fornecedor; experimente outro.”Os nomes de bucket são únicos em todo o fornecedor: escolha outro.
“A sua chave não tem permissão para o configurar.”Adicione a regra CORS manualmente, como explicado acima.
“Ainda não funciona. Reveja a regra e volte a verificar; alguns fornecedores demoram um minuto a aplicá-la.”Confirme que a origem é exatamente https://nubbo.app, sem barra final, espere um minuto e volte a verificar.
“Este bucket já está a ser utilizado.”Esse bucket já está ligado no Nubbo, na sua conta ou noutra.
“O bucket está numa região diferente. Verifique a região configurada.”Escolha no Nubbo a mesma região em que criou o bucket.
“Acesso negado. Verifique se as credenciais ainda estão ativas e as suas permissões.”Com uma chave limitada, confirme que tem Read/Write/Delete nesse bucket e que o bucket não tem nenhuma bucket policy.

Quanto custa

O Spaces é faturado com uma mensalidade que inclui armazenamento e transferência. Explicamos tudo em Preços do DigitalOcean Spaces.

Perguntas frequentes

Que tipo de chave do Spaces preciso?

Para o caminho automático, uma chave com Full access. Com uma chave limitada, uma chave Limited access com Read/Write/Delete no seu bucket.

Que região escolho no Nubbo?

A do bucket: nyc3, ams3, sfo2, sfo3, sgp1, lon1, fra1, tor1, blr1, syd1, atl1, ric1 ou mkc1. O painel de controlo mostra-a ao lado do nome do bucket.

Porque é que o Nubbo não consegue configurar o CORS com a minha chave limitada?

Porque, na DigitalOcean, alterar o CORS através da API exige uma chave com Full access. Com uma chave limitada, adicione você a regra em Settings, CORS Configurations.

Posso ligar buckets de várias regiões?

Sim. Cada bucket liga-se com a sua própria região e pode ter tantos quantos o seu plano permitir.

Fontes

Os preços e limites vêm das páginas oficiais abaixo. Os fornecedores alteram-nos, por isso confirme antes de se comprometer.