View a markdown version of this page

Tutorial: conceitos básicos do S3 Files - Amazon Simple Storage Service
Começar a usar o S3 Files por meio do Console da AWSComeçar a usar o S3 Files por meio da AWS CLI

Tutorial: conceitos básicos do S3 Files

Neste tutorial, você criará um sistema de arquivos do S3 e o montará em uma instância do EC2. Em seguida, você testará as operações básicas de arquivo. É possível usar o console do S3 ou a AWS CLI para começar a usar o S3 Files.

Começar a usar o S3 Files por meio do Console da AWS

O fluxo de trabalho do S3 Files no console do S3 consiste nas seguintes etapas:

  • Criar um sistema de arquivos do S3.

  • Montar o sistema de arquivos na instância do EC2 e executar operações do sistema de arquivos.

Pré-requisitos

Antes de começar, você deve:

Etapa 1: criar o sistema de arquivos do S3

  • Abra o console do Amazon S3, em https://console.aws.amazon.com/s3/.

  • Na barra de navegação, na parte superior da página, verifique se você está na região da AWS em que a instância do EC2 e o bucket do S3 estão localizados.

  • No painel de navegação à esquerda, escolha Buckets de uso geral.

  • Selecione o bucket para o qual você deseja criar o backup um sistema de arquivos.

  • Escolha a guia Sistemas de arquivos.

  • Escolha Create file system (Criar sistema de arquivos).

  • Analise e confirme sua VPC. Neste tutorial, use a VPC padrão.

  • Escolha Criar.

Quando um sistema de arquivos do S3 é criado com o Console de Gerenciamento da AWS, o S3 Files cria automaticamente um destino de montagem em cada zona de disponibilidade na VPC padrão e um ponto de acesso para o sistema de arquivos. Isso pode levar alguns minutos. O sistema de arquivos ficará disponível para a próxima etapa quando todos os recursos forem criados.

Etapa 2: montar o sistema de arquivos na instância do EC2

  • Na página Visão geral do sistema de arquivos, escolha Anexar em Anexar a uma instância do EC2. Isso abrirá uma nova página para a montagem do sistema de arquivos em uma instância do EC2.

  • Selecione a instância do EC2 desejada no menu suspenso Instâncias do EC2 disponíveis.

  • Insira um caminho na instância do EC2 em que você deseja montar o sistema de arquivos. Por exemplo, /mnt/s3files/.

  • Verifique se você configurou os Grupos de segurança corretos na instância do EC2 e no destino de montagem para permitir que o tráfego necessário flua.

  • É necessário ter o perfil do IAM correto com as permissões necessárias anexadas à instância do EC2 para que ela possa interagir com o sistema de arquivos do S3 e o bucket do S3. Para obter mais informações, consulte Perfil do IAM para anexar o sistema de arquivos a recursos de computação da AWS. Neste tutorial, você pode considerar a possibilidade de conceder acesso total ao cliente adicionando a política gerenciada AmazonS3FilesClientFullAccess ao perfil do IAM da instância do EC2.

  • Siga as instruções anexadas exibidas na página para abrir o CloudShell, montar o sistema de arquivos e executar operações básicas do sistema de arquivos.

Começar a usar o S3 Files por meio da AWS CLI

O fluxo de trabalho do S3 Files na AWS CLI consiste nas seguintes etapas:

  1. Criar o sistema de arquivos.

  2. Criar destinos de montagem para o sistema de arquivos.

  3. Montar o sistema de arquivos na instância do EC2 usando um destino de montagem.

  4. Testar operações de arquivo, como listar um diretório, gravar texto em um arquivo, ler um arquivo e copiar um arquivo. Em seguida, verificar se as alterações são reproduzidas no bucket do S3.

Pré-requisitos

Antes de começar, você deve:

Etapa 1: criar o sistema de arquivos do S3

Conecte-se à sua instância do EC2. Execute o comando create-file-system para criar um sistema de arquivos.

aws s3files create-file-system --region aws-region --bucket bucket-arn --role-arn iam-role

Substitua os seguintes valores pelos valores desejados:

  • aws-region: a região da AWS do bucket. Por exemplo, us-east-1.

  • bucket-arn: o ARN do bucket do S3.

  • iam-role: o ARN do perfil do IAM que o S3 Files assume para ler e gravar no bucket do S3. Verifique se você adicionou as permissões corretas a esse perfil do IAM. Para obter mais informações, consulte Perfil do IAM para acessar um bucket pelo sistema de arquivos.

Depois que o sistema de arquivos é criado com êxito, o S3 Files exibe a descrição do sistema de arquivos no formato JSON. Anote o ID do sistema de arquivos para a próxima etapa.

Etapa 2: criar destinos de montagem

Um destino de montagem oferece acesso de rede ao sistema de arquivos na VPC em uma única zona de disponibilidade. É necessário ter um destino de montagem para acessar o sistema de arquivos por meio dos recursos de computação. É possível criar no máximo um destino de montagem por zona de disponibilidade. Recomendamos criar um destino de montagem em cada zona de disponibilidade em que você opera.

Execute o comando create-mount-target a seguir para montar o sistema de arquivos. O subnet-id deve estar na mesma VPC da instância do EC2. É necessário criar um destino de montagem na mesma zona de disponibilidade da instância do EC2.

aws s3files create-mount-target --region aws-region --file-system-id file-system-id --subnet-id subnet-id

Aqui, file-system-id é o ID do sistema de arquivos recebido na resposta do comando create-file-system. Os destinos de montagem podem levar cerca de 5 minutos para serem criados.

Etapa 3: montar o sistema de arquivos na instância do EC2

Antes de montar o sistema de arquivos, verifique se você configurou os Grupos de segurança corretos no recurso de computação e o destino de montagem para permitir que o tráfego necessário flua. Para ver mais detalhes sobre grupos de segurança, acesse o Manual do usuário da VPC.

Execute os seguintes comandos para montar o sistema de arquivos:

  • Crie um diretório /mnt/s3files para usar como ponto de montagem do sistema de arquivos com o seguinte comando:

    sudo mkdir /mnt/s3files

  • Monte o sistema de arquivos:

    sudo mount -t s3files file-system-id:/ /mnt/s3files

Se você não tiver o ID do sistema de arquivos, poderá encontrá-lo executando o seguinte:

aws s3files get-file-system --region aws-region --file-system-id file-system-id

Etapa 4: testar operações de arquivo

Teste as operações básicas de arquivo no sistema de arquivos montado da seguinte forma:

  • Mude para o diretório que você montou:

    cd /mnt/s3files

  • É possível listar o conteúdo do diretório para verificar se o conteúdo do bucket ou prefixo de origem foi importado. A sincronização geralmente ocorre em questão de segundos, mas pode levar mais tempo, especialmente para o primeiro arquivo. Se o bucket estiver vazio, o comando abaixo também exibirá um resultado vazio.

    ls

  • Também é possível testar outras operações de arquivo:

    • Crie um arquivo:

      echo "Hello, S3 Files!" > test.txt

    • Leia o arquivo:

      cat test.txt

    • Crie um diretório:

      mkdir test-directory

    • Copie o arquivo no diretório:

      cp /mnt/s3files/test.txt /mnt/s3files/test-directory/

Em seguida, você pode acessar o bucket do S3 e verificar se o diretório test-directory é exibido no bucket. Observe que pode levar aproximadamente 1 minuto para sincronizar as alterações de volta para o bucket do S3.