Como configurar o DigitalOcean Spaces?

Use uma conta da DigitalOcean que permita criar um bucket do Spaces e chaves de acesso. A criação do seu primeiro bucket inicia uma assinatura paga do Spaces; o processamento pela Transloadit é cobrado separadamente.

1. Criar um bucket privado do Spaces

Siga o guia de criação de buckets⁠ da DigitalOcean. Escolha Standard Storage para este exemplo e mantenha o bucket privado. Anote o nome do bucket e o código da região, como nyc3, e não um endpoint completo ou uma URL de CDN.

2. Criar uma chave de acesso do Spaces restrita ao bucket

Siga o guia de chaves de acesso do Spaces⁠ da DigitalOcean. Escolha Limited access, selecione apenas este bucket e conceda a permissão Read/Write/Delete. A DigitalOcean não oferece uma chave do Spaces apenas para gravação: essa chave também pode ler e excluir objetos. Restringi-la a um bucket dedicado reduz os danos caso ela vaze. Chaves restritas a um bucket não podem ser combinadas com políticas de bucket PutBucketPolicy; use um bucket separado para este exemplo, se necessário.

Salve o ID da chave de acesso e o segredo com segurança. O segredo é exibido apenas quando a chave é criada. Use uma chave de acesso do Spaces, e não um token de API da conta da DigitalOcean.

3. Salvar Credenciais de Template

Siga Como criar Credenciais de Template e selecione DigitalOcean Spaces como serviço. Preencha:

Dê um nome reconhecível à Credencial. Use esse nome salvo no Template, e não o ID da chave de acesso.

4. Testar uma exportação

Crie um Template com estas instruções, substituindo YOUR_DIGITALOCEAN_CREDENTIALS pelo nome da Credencial que você salvou:

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "exported": {
      "robot": "/digitalocean/store",
      "use": ":original",
      "credentials": "YOUR_DIGITALOCEAN_CREDENTIALS",
      "acl": "private"
    }
  }
}

Execute o Template com um pequeno upload de teste. Após a conclusão da Assembly, inspecione o resultado da exportação e confirme que o objeto existe no Control Panel da DigitalOcean, com sua sessão autenticada. Uma simples URL de resultado não concede acesso anônimo a esse objeto privado. Se sua aplicação precisar de uma URL de download com prazo de validade, consulte sign_urls_for na documentação do 🤖/digitalocean/store.

Saiba mais

• Consulte a documentação de Templates para saber sobre configuração e segurança de Templates.
• Consulte a documentação do 🤖/digitalocean/store para saber sobre caminhos de arquivos, configurações de acesso e outras opções de exportação.