Skip to content

Latest commit

 

History

History
130 lines (102 loc) · 6.46 KB

index.mdx

File metadata and controls

130 lines (102 loc) · 6.46 KB
Raw
title description meta_tags namespace permalink
Como acessar o Edge Storage usando o protocolo S3
O Edge Storage oferece compatibilidade com o protocolo S3 por meio de credenciais. Gere uma access key e uma secret key para qualquer bucket que você possua para permitir operações específicas para cada acesso verificado com a credencial.
object storage, storage, cloud, s3, bucket, file storage, edge storage, s3 protocol
documentation_guides_s3_protocol_edge_storage
/documentacao/produtos/guias/protocolo-s3-para-edge-storage/

O Edge Storage da Azion oferece compatibilidade com o protocolo S3 por meio de credenciais. Quando você cria uma credencial para qualquer bucket que você possui, você receberá uma access key e uma secret key para configurar permissões para operações. O acesso ao seu bucket por meio do protocolo S3 será verificado usando a credencial.

O protocolo S3 permite que você acesse buckets e objetos usando uma URL do Edge Storage. Esta configuração facilita operações de arquivo por meio de ferramentas de interface de linha de comando (CLI), como s3cmd, serviços de banco de dados ou funções.

Crie uma credencial via API

  1. Execute a seguinte requisição POST no seu terminal, substituindo [TOKEN VALUE] pelo seu personal token:
curl --location 'https://api.azion.com/v4/storage/s3-credentials' \
--header 'Accept: application/json' \
--header 'Authorization: Token [TOKEN VALUE]' \
--header 'Content-Type: application/json' \
--data '{
    "name": "my-s3-credential",
    "capabilities": [
        "listAllBucketNames",
        "listBuckets",
        "listFiles",
        "readFiles",
        "writeFiles",
        "deleteFiles"
    ],
    "bucket": "<bucket_name>",
    "expiration_date": "<datetime>"
}'
Chave Descrição
name Define a string em valor como um nome da credencial
capabilities Recebe uma lista de capabilities para permitir a realização de operações
bucket Opcional. Restringe o uso da credencial apenas ao bucket adicionado
expiration_date Estabelece o tempo para a expiração da credencial. O formato datetime deve estar no padrão UTC ISO 8601: YYYY-MM-DDT00:00:00Z
  1. Você deve receber uma resposta semelhante a esta:
{
    "state": "executed",
    "data": {
        "name": "my-s3-credential",
        "access_key": "<s3_credential_access_key>",
        "secret_key": "<s3_credential_secret_key>", // esse valor não poderá mais ser acessado em requisições futuras
        "capabilities": [
            "listAllBucketNames",
            "listBuckets",
            "listFiles",
            "readFiles",
            "writeFiles",
            "deleteFiles"
        ],
        "bucket": "<bucket_name>",
        "expiration_date": "<datetime>",
        "created_at": "<datetime>"
    }
}
  1. Copie os valores de access_key e secret_key para configurar o acesso através do protocolo S3.

Configure o acesso ao bucket através do s3cmd

s3cmd é uma ferramenta de interface de linha de comando (CLI) para gerenciar o S3 e outros serviços de armazenamento em nuvem. Pode ser usada para gerenciar objetos no Edge Storage e outros serviços de armazenamento compatíveis com S3.

Para usar o s3cmd para gerenciar seu bucket no Edge Storage, siga estes passos:

  1. Baixe e instale o pacote s3cmd através do site oficial.
  2. Certifique-se de que o s3cmd esteja adicionado ao PATH do seu sistema.
  3. Execute s3cmd --configure e insira a access key e a secret key.
  4. Insira a região padrão para a região do Edge Storage: us-east.
  5. Insira a URL do endpoint para o Edge Storage: s3.us-east-005.azionstorage.net.
  6. Use o template DNS padrão: %(bucket).s3.us-east-005.azionstorage.net.
  7. Informe uma senha de criptografia e um caminho para um programa GPG, se necessário.

:::note O Gnu Privacy Guard (GPG) é um software de criptografia gratuito e de código aberto que fornece uma camada adicional de privacidade criptográfica e autenticação para comunicação por protocolo S3. Consulte a documentação do GnuPG para mais informações. ::: 8. Ative o protocolo HTTPS digitando true. 9. Informe servidores proxy HTTP, se necessário. 10. Pressione y para testar o acesso.

Se suas chaves de acesso e secreta estiverem corretas, você deverá receber a seguinte mensagem de sucesso:

Please wait, attempting to list all buckets...
Success. Your access key and secret key worked fine :-)

Você pode salvar suas configurações em um arquivo .s3cfg se necessário e modificá-las novamente usando s3cmd --configure. Execute o comando s3cmd --help para ver todos os comandos disponíveis.

Comandos s3cmd para gerenciar objetos no Edge Storage

Depois de configurar o acesso ao bucket através do s3cmd, você pode executar operações para gerenciar seus objetos no Edge Storage usando os comandos disponíveis.

Escopo Descrição
s3cmd ls Listar todos os seus buckets
s3cmd mb s3://meu-novo-nome-do-bucket Criar um novo bucket. Os nomes dos buckets devem ser únicos e as melhores práticas para nomear buckets incluem especificar que tipos de objetos estão armazenados e o tipo de permissões para os objetos
s3cmd ls s3://meu-novo-nome-do-bucket Listar o conteúdo do bucket
s3cmd put file.xml s3://meu-novo-nome-do-bucket/file.xml Fazer upload de um arquivo para o bucket
s3cmd get s3://meu-novo-nome-do-bucket/file.xml file-2.xml Recuperar o arquivo e verificar se ele não foi corrompido
s3cmd del s3://meu-novo-nome-do-bucket/addrbook.xml s3://meu-novo-nome-do-bucket/storage.jpg Excluir o objeto
s3cmd rb s3://logix.cz-test Remover o bucket. Apenas buckets vazios podem ser removidos

:::note Se algum arquivo foi excluído nas últimas 24 horas do bucket especificado, a ação de excluir o bucket inteiro será bloqueada. É recomendado esperar pelo menos 24 horas após excluir os arquivos antes de tentar excluir o bucket inteiro. :::

Para mais detalhes sobre o protocolo S3 e os comandos s3cmd, consulte a documentação oficial. Você também pode visitar a referência do Edge Storage.

import ContributorList from '~/components/ContributorList.astro'

Contribuidores Contributor