Primeiros passos com Object Storage
Crie o seu primeiro bucket do Object Storage pelo Azion Console, pela Azion CLI ou pela API, faça upload de um objeto e confirme que ele está armazenado.
Este guia orienta você a armazenar o seu primeiro objeto no Object Storage. No fim, você vai ter:
- O seu primeiro bucket, que a Azion Platform lê sem modificar.
- Um objeto armazenado nesse bucket, endereçado pela sua key.
- O objeto listado no bucket, o que confirma o upload.
Um bucket não é uma pasta pública: um objeto do qual você faz upload não responde a nenhuma requisição vinda da internet enquanto uma aplicação não apontar para ele. O resultado se apoia em três objetos, nesta ordem. O bucket é o container de nível mais alto para objetos e buckets não são aninhados. Cada objeto dentro dele é um arquivo, a sua key e o seu content type. A key endereça o objeto: uma / em uma key faz parte da key, não é uma pasta. Um connector do tipo Object Storage, combinado com uma regra do Rules Engine em uma aplicação, é o que envia uma requisição ao bucket. Este guia cria os dois primeiros e para por aí.
Selecione a interface que você vai usar. Os pré-requisitos e todas as etapas abaixo seguem essa escolha.
Pré-requisitos
- Um arquivo na sua máquina para fazer upload, como uma imagem.
- Permissão para criar buckets e objetos na sua conta. Para mais informações, consulte Como gerenciar permissões de times.
- Acesso ao Azion Console. Para entrar, consulte Como acessar o Azion Console.
Crie um bucket
Um bucket guarda os objetos dos quais você faz upload. Este dá à Azion Platform acesso somente de leitura, o nível para conteúdo que a plataforma entrega sem modificar.
Um nome de bucket tem de 6 a 63 caracteres, usa letras, números e o hífen e nunca começa com azion. Ele é único em todas as contas Azion, então um nome curto e genérico provavelmente já está reservado.
Para criar o bucket pelo Azion Console:
Acesse Azion Console > Object Storage > Buckets.
Inicie um novo bucket a partir da lista de Buckets. Uma conta que ainda não tem buckets oferece Bucket na lista vazia.
Em General, em Name, insira um nome seu.
Em Settings, mantenha Workloads Access como Read Only, o padrão, para que a plataforma leia os objetos, mas não possa modificá-los.
O bucket aparece em Buckets, que lista o seu Name, Size, Last Editor e Last Modified.
Faça upload de um objeto
Um objeto é armazenado sob uma key e a key é como toda interface o endereça depois. Uma key tem de 1 a 1.024 caracteres.
Para fazer upload do arquivo pelo Azion Console:
Em Buckets, selecione o bucket que você criou.
Selecione Upload files ou arraste o arquivo até a área de destino. O nome do arquivo se torna a key do objeto. O Console recusa um arquivo maior que 300 MB.
O objeto é armazenado no bucket, sob a key retirada do nome do arquivo.
Confirme que o objeto está armazenado
O bucket lista o que guarda, então você pode confirmar o upload sem outra interface.
Para encontrar o objeto pelo Azion Console:
Acesse Azion Console > Object Storage > Buckets.
Selecione o bucket que você criou.
O objeto é listado sob a sua key. Uma key que carrega uma /, como images/logo.svg, agrupa sob o segmento anterior: esse segmento é um prefix, não uma pasta.
O objeto está listado sob a sua key, o que confirma o upload.
O seu primeiro objeto está armazenado no Object Storage e endereçado pela sua key. O bucket é alcançável pelo Azion Console, pela Azion CLI, pela Azion API e pelo protocolo S3. Por enquanto, por mais nada.
Para entregar o objeto aos usuários finais, aponte um connector do tipo Object Storage para o bucket. Uma regra do Rules Engine na aplicação então envia as requisições que casam para ele. Para mais informações, consulte Use um bucket do Object Storage como origem.