# Tutorial: conceitos básicos do S3 Files
<a name="s3-files-getting-started"></a>

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
<a name="s3-files-getting-started-console"></a>

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
<a name="s3-files-getting-started-console-prereqs"></a>

Antes de começar, você deve:
+ Concluir a [Configuração da conta e computação da AWS](s3-files-prereq-policies.md#s3-files-prereq-account-setup).
+ Você tem o Amazon EC2 configurado e sabe executar instâncias do EC2. Para obter mais informações, consulte [Conceitos básicos do Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) no *Guia do usuário do Amazon EC2*. Neste tutorial, use a VPC padrão para a instância do EC2.
+ Ter um [Perfil do IAM para anexar o sistema de arquivos a recursos de computação da AWS](s3-files-prereq-policies.md#s3-files-prereq-iam-compute-role) anexado à instância EC2 para que ela possa interagir com o sistema de arquivos do S3 e o bucket do S3.

### Etapa 1: criar o sistema de arquivos do S3
<a name="s3-files-getting-started-console-step1"></a>
+ Abra o console do Amazon S3, em [https://console.aws.amazon.com/s3/](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
<a name="s3-files-getting-started-console-step2"></a>
+ 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](s3-files-prereq-policies.md#s3-files-prereq-security-groups) 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](s3-files-prereq-policies.md#s3-files-prereq-iam-compute-role). 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
<a name="s3-files-getting-started-cli"></a>

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

1. Criar o sistema de arquivos.

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

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

1. 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
<a name="s3-files-getting-started-cli-prereqs"></a>

Antes de começar, você deve:
+ Ter instalado e configurado a AWS CLI. Para obter mais informações, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
+ Cumprir todos os pré-requisitos descritos em [Pré-requisitos referentes ao S3 Files](s3-files-prereq-policies.md).
+ Você tem o Amazon EC2 configurado e sabe executar instâncias do EC2. Você precisa de uma conta da AWS, um usuário com acesso administrativo, um par de chaves e um grupo de segurança. Para obter mais informações, consulte [Conceitos básicos do Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) no *Guia do usuário do Amazon EC2*.

### Etapa 1: criar o sistema de arquivos do S3
<a name="s3-files-getting-started-cli-step1"></a>

[Conecte-se à sua instância do EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect.html). 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](s3-files-prereq-policies.md#s3-files-prereq-iam-creation-role).

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
<a name="s3-files-getting-started-cli-step2"></a>

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
<a name="s3-files-getting-started-cli-step3"></a>

Antes de montar o sistema de arquivos, verifique se você configurou os [Grupos de segurança](s3-files-prereq-policies.md#s3-files-prereq-security-groups) 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](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html).

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
<a name="s3-files-getting-started-cli-step4"></a>

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.