

# Montar um bucket do Amazon S3 como um sistema de arquivos local
<a name="mountpoint"></a>

O Mountpoint para Amazon S3 é um cliente de arquivos de código aberto com alta taxa de throughput para montar um bucket do Amazon S3 como um sistema de arquivos local. Com o Mountpoint, as aplicações podem acessar objetos armazenados no Amazon S3 por meio de operações do sistema de arquivo, como abertura e leitura. O Mountpoint traduz automaticamente essas operações em chamadas de API de objetos do S3, dando aos aplicativos acesso ao armazenamento elástico e ao throughput do Amazon S3 por meio de uma interface de arquivo.

O Mountpoint para Amazon S3 está [disponível para uso na produção, em aplicações em grande escala com uso intenso de leitura](https://aws.amazon.com/blogs/aws/mountpoint-for-amazon-s3-generally-available-and-ready-for-production-workloads/): data lakes, treinamento de machine learning, renderização de imagens, simulação de veículos autônomos, extração, transformação e carregamento (ETL) e muito mais. 

O Mountpoint permite operações básicas de sistema de arquivos e pode ler arquivos de até 50 TB. Ele pode listar e ler arquivos existentes e criar outros. Ele não pode modificar arquivos existentes nem excluir diretórios e não é compatível com links simbólicos ou bloqueio de arquivos. O Mountpoint é ideal para aplicações que não precisam de todos os recursos de um sistema de arquivos compartilhado e de permissões no estilo POSIX, mas exigem o throughput elástico do Amazon S3 para ler e gravar grandes conjuntos de dados do S3. Para obter detalhes, consulte [Comportamento do sistema de arquivos do Mountpoint](https://github.com/awslabs/mountpoint-s3/blob/main/doc/SEMANTICS.md) no GitHub. Quanto a workloads que exigem compatibilidade total com o POSIX, recomendamos o [Amazon FSx para Lustre](https://aws.amazon.com/fsx/lustre/), que [permite vincular buckets do Amazon S3](https://docs.aws.amazon.com/fsx/latest/LustreGuide/create-dra-linked-data-repo.html).

O Mountpoint para Amazon S3 está disponível somente para sistemas operacionais Linux. Você pode usar o Mountpoint para acessar objetos do S3 em todas as classes de armazenamento, exceto S3 Glacier Flexible Retrieval, S3 Glacier Deep Archive, S3 Intelligent-Tiering Archive Access Tier e S3 Intelligent-Tiering Deep Archive Access Tier.

**Topics**
+ [

# Instalar o Mountpoint
](mountpoint-installation.md)
+ [

# Configurar e usar o Mountpoint
](mountpoint-usage.md)
+ [

# Solução de problemas do Mountpoint
](mountpoint-troubleshooting.md)

# Instalar o Mountpoint
<a name="mountpoint-installation"></a>

Você pode baixar e instalar pacotes pré-compilados do Mountpoint para Amazon S3 usando a linha de comando. As instruções para baixar e instalar o Mountpoint variam, dependendo de qual sistema operacional Linux você está usando. 

**Topics**
+ [

## Amazon Linux 2023 (AL2023)
](#mountpoint-install-al2023)
+ [

## Distribuições baseadas no RPM (Amazon Linux 2, Fedora, CentOS e RHEL)
](#mountpoint-install-rpm)
+ [

## Distribuições baseadas em DEB (Debian, Ubuntu)
](#mountpoint.install.deb)
+ [

## Outras distribuições do Linux
](#mountpoint-install-other)
+ [

## Conferir a assinatura do pacote do Mountpoint para Amazon S3
](#mountpoint-install-verify)

## Amazon Linux 2023 (AL2023)
<a name="mountpoint-install-al2023"></a>

O Mountpoint está disponível diretamente no repositório do Amazon Linux 2023 desde a versão 2023.9.20251110 do AL2023.

1. Instale-o inserindo o seguinte comando:

   ```
   sudo dnf install mount-s3
   ```

1. Confira se o Mountpoint para Amazon S3 foi instalado com êxito:

   ```
   mount-s3 --version
   ```

   Você deve ver uma saída semelhante a:

   ```
   mount-s3 1.21.0+1.amzn2023
   ```

## Distribuições baseadas no RPM (Amazon Linux 2, Fedora, CentOS e RHEL)
<a name="mountpoint-install-rpm"></a>

1. Copie o URL de download a seguir referente à sua arquitetura.

   *x86\$164*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.rpm
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.rpm
   ```

1. Baixe o pacote do Mountpoint para Amazon S3. Substitua `download-link` pelo URL de download apropriado da etapa anterior.

   ```
   wget download-link
   ```

1. (Opcional) Verifique a integridade e a autenticidade do arquivo baixado. Primeiro, copie o URL de assinatura apropriado para a sua arquitetura. 

   *x86\$164*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.rpm.asc
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.rpm.asc
   ```

   Depois, consulte [Verificar a assinatura do pacote do Mountpoint para Amazon S3](#mountpoint-install-verify).

1. Instale o pacote usando o seguinte comando:

   ```
   sudo yum install ./mount-s3.rpm
   ```

1. Confira se o Mountpoint foi instalado com êxito digitando o seguinte comando:

   ```
   mount-s3 --version
   ```

   Você deve ver uma saída semelhante a:

   ```
   mount-s3 1.21.0
   ```

## Distribuições baseadas em DEB (Debian, Ubuntu)
<a name="mountpoint.install.deb"></a>

1. Copie o URL de download para a arquitetura. 

   *x86\$164*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.deb
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.deb
   ```

1. Baixe o pacote do Mountpoint para Amazon S3. Substitua `download-link` pelo URL de download apropriado da etapa anterior.

   ```
   wget download-link
   ```

1. (Opcional) Verifique a integridade e a autenticidade do arquivo baixado. Primeiro, copie o URL de assinatura para a arquitetura.

   *x86\$164*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.deb.asc
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.deb.asc
   ```

   Depois, consulte [Verificar a assinatura do pacote do Mountpoint para Amazon S3](#mountpoint-install-verify).

1. Instale o pacote usando o seguinte comando:

   ```
   sudo apt-get install ./mount-s3.deb
   ```

1. Confira se o Mountpoint para Amazon S3 foi instalado com êxito digitando o seguinte comando:

   ```
   mount-s3 --version
   ```

   Você deve ver uma saída semelhante a:

   ```
   mount-s3 1.21.0
   ```

## Outras distribuições do Linux
<a name="mountpoint-install-other"></a>

1. Consulte a documentação do sistema operacional para instalar os pacotes `FUSE` e `libfuse2`, que são obrigatórios. 

1. Copie o URL de download para a arquitetura. 

   *x86\$164*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.tar.gz
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.tar.gz
   ```

1. Baixe o pacote do Mountpoint para Amazon S3. Substitua `download-link` pelo URL de download apropriado da etapa anterior.

   ```
   wget download-link
   ```

1. (Opcional) Verifique a integridade e a autenticidade do arquivo baixado. Primeiro, copie o URL de assinatura para a arquitetura. 

   *x86\$164*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.tar.gz.asc
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.tar.gz.asc
   ```

   Depois, consulte [Verificar a assinatura do pacote do Mountpoint para Amazon S3](#mountpoint-install-verify).

1. Instale o pacote usando o seguinte comando:

   ```
   sudo mkdir -p /opt/aws/mountpoint-s3 && sudo tar -C /opt/aws/mountpoint-s3 -xzf ./mount-s3.tar.gz
   ```

1. Adicione o `mount-s3` binário à variável de ambiente `PATH`. No arquivo `$HOME/.profile`, anexe a seguinte linha:

   ```
   export PATH=$PATH:/opt/aws/mountpoint-s3/bin
   ```

   Salve o arquivo `.profile` e execute o seguinte comando:

   ```
   source $HOME/.profile
   ```

1. Confira se o Mountpoint para Amazon S3 foi instalado com êxito digitando o seguinte comando:

   ```
   mount-s3 --version
   ```

   Você deve ver uma saída semelhante a:

   ```
   mount-s3 1.21.0
   ```

## Conferir a assinatura do pacote do Mountpoint para Amazon S3
<a name="mountpoint-install-verify"></a><a name="verify"></a>

1. Instale GnuPG (o comando `gpg`). É necessário verificar a autenticidade e a integridade de um pacote do Mountpoint para Amazon S3 baixado. GnuPG é instalado por padrão em imagens de máquina da Amazon (AMIs) do Linux Amazon. Depois de instalar GnuPG, vá para a etapa 2. 

1. Baixe a chave pública do Mountpoint executando o seguinte comando:

   ```
   wget https://s3.amazonaws.com/mountpoint-s3-release/public_keys/KEYS
   ```

1. Importe a chave pública do Mountpoint para o token de autenticação executando o seguinte comando:

   ```
   gpg --import KEYS
   ```

1. Verifique a impressão digital da chave pública do Mountpoint executando o seguinte comando:

   ```
   gpg --fingerprint mountpoint-s3@amazon.com
   ```

   Confirme se a string de impressões digitais exibida corresponde ao seguinte:

   ```
   673F E406 1506 BB46 9A0E  F857 BE39 7A52 B086 DA5A
   ```

   Se a string de impressões digitais não coincidir, não conclua a instalação do Mountpoint. Nesse caso, entre em contato com o [AWS Support](https://aws.amazon.com/premiumsupport/).

1. Faça download do arquivo SIGNATURE do pacote. Substitua `signature-link` pelo link de assinatura apropriado das seções anteriores.

   ```
   wget signature-link
   ```

1. Verifique a assinatura do pacote baixado executando o comando a seguir. Substitua `signature-filename` pelo nome do arquivo da etapa anterior.

   ```
   gpg --verify signature-filename
   ```

   Por exemplo, em distribuições com base em RPM, incluindo o Amazon Linux, execute o seguinte comando:

   ```
   gpg --verify mount-s3.rpm.asc
   ```

1. A saída deve incluir a frase `Good signature`. Se a saída incluir a frase `BAD signature`, baixe novamente o arquivo do pacote do Mountpoint e repita essas etapas. Se o problema persistir, não conclua a instalação do Mountpoint. Nesse caso, entre em contato com o [AWS Support](https://aws.amazon.com/premiumsupport/). 

   A saída pode incluir um aviso sobre uma assinatura confiável. Isso não indica um problema. Significa apenas que você não verificou de forma independente a chave pública do Mountpoint.

# Configurar e usar o Mountpoint
<a name="mountpoint-usage"></a>

Para usar o Mountpoint para Amazon S3, o host precisa de credenciais válidas da AWS, com acesso ao bucket do Amazon S3 ou aos buckets que você gostaria de montar. Para diferentes formas de autenticação, consulte [Credenciais da AWS](https://github.com/awslabs/mountpoint-s3/blob/main/doc/CONFIGURATION.md#aws-credentials) para o Mountpoint no GitHub. 

Por exemplo, você pode criar um usuário e um perfil do AWS Identity and Access Management (IAM) para essa finalidade. Esse perfil deve ter acesso ao bucket ou aos buckets que você gostaria de montar. É possível [transmitir o perfil do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) à instância do Amazon EC2 com um perfil de instância. 

**Topics**
+ [

## Usar o Mountpoint para Amazon S3
](#using-mountpoint)
+ [

## Configurar o armazenamento em cache no Mountpoint
](#mountpoint-caching)

## Usar o Mountpoint para Amazon S3
<a name="using-mountpoint"></a>

Use o Mountpoint para Amazon S3 para fazer o seguinte:

1. Monte seus buckets do Amazon S3.

   1. Você pode montar os buckets do Amazon S3 manualmente usando o comando `mount-s3`. 

      No exemplo a seguir, substitua `amzn-s3-demo-bucket` pelo nome do bucket do S3 e substitua `~/mnt` pelo diretório no host em que você deseja montar o bucket do S3.

      ```
      mkdir ~/mnt
      mount-s3 amzn-s3-demo-bucket ~/mnt
      ```

      Como o cliente do Mountpoint é executado em segundo plano por padrão, o diretório `~/mnt` agora oferece acesso aos objetos no bucket do Amazon S3.

   1. A partir do Mountpoint v1.18, também é possível configurar a montagem automática de buckets do Amazon S3 quando uma instância é inicializada ou reinicializada. 

      Para instâncias do Amazon EC2 existentes ou em execução, encontre o arquivo `fstab` no diretório `/etc/fstab` do seu sistema Linux. Em seguida, adicione uma linha ao seu arquivo `fstab`. Por exemplo, para montar *amzn-s3-demo-bucket* usando o prefixo `example-prefix/` do caminho do sistema `/mnt/mountpoint`, consulte o seguinte. Para usar o exemplo a seguir, substitua os *espaços reservados para entrada do usuário* por suas próprias informações. 

      ```
      s3://amzn-s3-demo-bucket/example-prefix/ /mnt/mountpoint mount-s3 _netdev,nosuid,nodev,nofail,rw 0 0
      ```

      Consulte a tabela a seguir para obter uma explicação sobre as opções usadas no exemplo.    
<a name="auto-mount-commands"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/mountpoint-usage.html)

      Para novas instâncias do Amazon EC2, você pode modificar os dados do usuário em um modelo do Amazon EC2 e configurar o arquivo `fstab` da forma a seguir. Para usar o exemplo a seguir, substitua os *espaços reservados para entrada do usuário* por suas próprias informações.

      ```
      #!/bin/bash -e
      MP_RPM=$(mktemp --suffix=.rpm)
      curl https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.rpm > $MP_RPM
      yum install -y $MP_RPM
      rm $MP_RPM
      
      MNT_PATH=/mnt/mountpoint
      echo "s3://amzn-s3-demo-bucket/ ${MNT_PATH} mount-s3 _netdev,nosuid,nodev,rw,allow-other,nofail" >> /etc/fstab
      mkdir $MNT_PATH
      
      systemctl daemon-reload
      mount -a
      ```

1. Acesse os objetos no bucket do Amazon S3 por meio do Mountpoint.

   Depois de montar o bucket localmente, você pode usar os comandos Linux comuns, como `cat` ou `ls`, para trabalhar com os objetos do S3. O Mountpoint para Amazon S3 interpreta as chaves no bucket do Amazon S3 como caminhos do sistema de arquivos dividindo-as com o caractere de barra (`/`). Por exemplo, se você tiver a chave do objeto `Data/2023-01-01.csv` no bucket, terá um diretório chamado `Data` no sistema de arquivos do Mountpoint, o qual contém um arquivo chamado `2023-01-01.csv`. 

   O Mountpoint para Amazon S3 não implementa intencionalmente a especificação padrão completa [POSIX](https://en.wikipedia.org/wiki/POSIX) para sistemas de arquivos. O Mountpoint é otimizado para workloads que, embora precisem de alta taxa de throughput para acesso de leitura e gravação aos dados armazenados no Amazon S3 por meio de uma interface de sistema de arquivos, de outra forma não dependem dos atributos do sistema de arquivos. Para receber mais informações, consulte [Comportamento do sistema de arquivos](https://github.com/awslabs/mountpoint-s3/blob/main/doc/SEMANTICS.md) do Mountpoint para Amazon S3 no GitHub. Os clientes que precisam de uma semântica mais completa do sistema de arquivos devem considerar outros serviços de arquivos AWS, como [Amazon Elastic File System (Amazon EFS)](https://aws.amazon.com/efs/) ou [Amazon FSx](https://aws.amazon.com/fsx/).

   

1. Desmonte o bucket do Amazon S3 usando o comando `umount`. Esse comando desmonta o bucket do S3 e sai do Mountpoint. 

   Para usar o comando de exemplo a seguir, substitua `~/mnt` pelo diretório no host em que o bucket do S3 está montado.

   ```
   umount ~/mnt
   ```
**nota**  
Para receber uma lista de opções para esse comando, execute `umount --help`.

Para obter detalhes adicionais sobre a configuração do Mountpoint, consulte [S3 bucket configuration](https://github.com/awslabs/mountpoint-s3/blob/main/doc/CONFIGURATION.md#s3-bucket-configuration) e [File system configuration](https://github.com/awslabs/mountpoint-s3/blob/main/doc/CONFIGURATION.md#file-system-configuration) no GitHub.

## Configurar o armazenamento em cache no Mountpoint
<a name="mountpoint-caching"></a>

O Mountpoint para Amazon S3 é compatível com diferentes tipos de armazenamento em cache de dados. Para acelerar as solicitações de leitura repetidas, você pode optar pelo seguinte: 
+ **Cache local**: você pode usar um cache local em seu armazenamento de instância do Amazon EC2 ou em um volume do Amazon Elastic Block Store. Se você ler repetidamente os mesmos dados da mesma instância de computação e tiver espaço não utilizado no armazenamento da instância local para o conjunto de dados lido repetidamente, opte por um cache local. 
+ **Cache compartilhado**: você pode usar um cache compartilhado na classe S3 Express One Zone. Se você lê repetidamente objetos pequenos de várias instâncias de computação ou se não sabe o tamanho do conjunto de dados lido repetidamente e quer se beneficiar da elasticidade do tamanho do cache, opte pelo cache compartilhado. Depois de definir essa opção, o Mountpoint retém objetos com tamanhos de até um megabyte em um bucket de diretório que usa a classe S3 Express One Zone. 
+ **Cache local e compartilhado combinados**: se você tem espaço não utilizado no cache local, mas também quer um cache compartilhado em várias instâncias, pode optar por um cache local e um cache compartilhado. 

O armazenamento em cache no Mountpoint é ideal para casos de uso em que você lê repetidamente os mesmos dados que não mudam durante as várias leituras. Por exemplo, você pode usar o armazenamento em cache com trabalhos de treinamento de machine learning que precisam ler um conjunto de dados de treinamento várias vezes para melhorar a precisão do modelo.

Consulte mais informações sobre como configurar o armazenamento em cache no Mountpoint nos exemplos a seguir.

**Topics**
+ [

### Cache local
](#local-cache-example)
+ [

### Cache compartilhado
](#shared-cache-example)
+ [

### Cache local e compartilhado combinados
](#shared-local-cache-example)

### Cache local
<a name="local-cache-example"></a>

Você pode optar por um cache local com a sinalização `--cache CACHE_PATH`. No exemplo a seguir, substitua *`CACHE_PATH`* pelo caminho de arquivo do diretório no qual você deseja armazenar os dados em cache. Substitua *`amzn-s3-demo-bucket`* pelo nome do bucket do Amazon S3 e substitua *`~/mnt`* pelo diretório no host em que você deseja montar o bucket do S3.

```
mkdir ~/mnt
mount-s3 --cache CACHE_PATH amzn-s3-demo-bucket ~/mnt
```

Quando você opta pelo armazenamento em cache local ao montar um bucket do Amazon S3, o Mountpoint cria um subdiretório vazio no local do cache configurado, caso esse subdiretório ainda não exista. Quando você monta um bucket pela primeira vez e quando desmonta, o Mountpoint exclui o conteúdo do cache local.

**Importante**  
Se você habilitar o armazenamento em cache local, o Mountpoint manterá o conteúdo de objeto não criptografado do bucket do Amazon S3 montado na localização do cache local indicada na montagem. Para proteger os dados, você deve restringir o acesso à localização do cache de dados usando mecanismos de controle de acesso ao sistema de arquivos.

### Cache compartilhado
<a name="shared-cache-example"></a>

Se você lê repetidamente objetos pequenos (até 1 MB) de várias instâncias de computação ou se o tamanho do conjunto de dados que você lê repetidamente geralmente excede o tamanho do cache local, use um cache compartilhado na classe [S3 Express One Zone](https://aws.amazon.com/s3/storage-classes/express-one-zone/). Quando você lê os mesmos dados repetidamente de várias instâncias, isso melhora a latência ao evitar solicitações redundantes para o bucket do Amazon S3 montado. 

Depois de optar pelo cache compartilhado, você paga pelos dados armazenados no bucket de diretório na classe S3 Express One Zone. Você também paga pelas solicitações feitas com relação aos seus dados no bucket de diretório na classe S3 Express One Zone. Para obter mais informações, consulte [Preço do Amazon S3](https://aws.amazon.com/s3/pricing/). O Mountpoint nunca exclui objetos em cache dos buckets de diretório. Para gerenciar os custos de armazenamento, você deve configurar uma [política de ciclo de vida no bucket de diretório](https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-lifecycle.html) para que o Amazon S3 expire os dados em cache na classe S3 Express One Zone após um período especificado por você. Consulte mais informações em [Mountpoint for Amazon S3 caching configuration](https://github.com/awslabs/mountpoint-s3/blob/main/doc/CONFIGURATION.md#caching-configuration) no GitHub.

Para optar pelo armazenamento em cache na classe S3 Express One Zone ao montar um bucket do Amazon S3 na instância de computação, use a sinalização `--cache-xz` e especifique um bucket de diretório como a localização do cache. No exemplo a seguir, substitua os *espaços reservados de entrada do usuário*.

```
mount-s3 amzn-s3-demo-bucket ~/mnt --cache-xz amzn-s3-demo-bucket--usw2-az1--x-s3
```

### Cache local e compartilhado combinados
<a name="shared-local-cache-example"></a>

Se você tem espaço não utilizado na instância, mas também quer usar um cache compartilhado em várias instâncias, pode optar por um cache local e um cache compartilhado. Com essa configuração de cache, você pode evitar solicitações de leitura redundantes da mesma instância para o cache compartilhado no bucket do diretório quando os dados necessários são armazenados em cache no armazenamento local. Isso pode reduzir os custos e melhorar o desempenho.

 Para optar por um cache local e compartilhado ao montar um bucket do Amazon S3, especifique as localizações de ambos os caches usando os sinalizadores `--cache` e `--cache-xz`. Para usar o exemplo a seguir para optar por um cache local e compartilhado, substitua os *espaços reservados de entrada do usuário*.

```
mount -s3 amzn-s3-demo-bucket ~/mnt --cache /path/to/mountpoint/cache --cache -xz amzn-s3-demo-bucket--usw2-az1--x-s3
```

Consulte mais informações em [Mountpoint for Amazon S3 caching configuration](https://github.com/awslabs/mountpoint-s3/blob/main/doc/CONFIGURATION.md#caching-configuration) no GitHub. 

**Importante**  
Se você habilitar o armazenamento em cache compartilhado, o Mountpoint copiará o conteúdo do objeto do bucket do Amazon S3 montado para o bucket do diretório do S3 que você fornece como a localização do cache compartilhado, tornando-o acessível a qualquer chamador com acesso ao bucket de diretório do S3. Para proteger os dados em cache, você deve seguir as [Práticas recomendadas de segurança para o Amazon S3](security-best-practices.md) para garantir que os buckets utilizem as políticas corretas e não sejam acessados publicamente. Você deve usar um bucket de diretório dedicado para o cache compartilhado do Mountpoint e conceder acesso somente aos clientes do Mountpoint.

# Solução de problemas do Mountpoint
<a name="mountpoint-troubleshooting"></a>

O Mountpoint para Amazon S3 conta com o suporte do Suporte. Se precisar de ajuda, entre em contato com o [AWS Support Center](https://console.aws.amazon.com/support/home#/). 

Você também pode examinar e enviar [Problemas](https://github.com/awslabs/mountpoint-s3/issues) do Mountpoint no GitHub.

Se você descobrir um possível problema de segurança nesse projeto, pedimos que você notifique a Segurança da AWS por meio de nossa página [Relatório de vulnerabilidade](https://aws.amazon.com/security/vulnerability-reporting/). Não crie um problema público no GitHub.

Se a aplicação se comportar inesperadamente com o Mountpoint, você poderá inspecionar as informações de log para diagnosticar o problema. 

**Registro em log de**

Por padrão, o Mountpoint emite informações de log de alta gravidade para [https://datatracker.ietf.org/doc/html/rfc5424](https://datatracker.ietf.org/doc/html/rfc5424). 

Para visualizar os logs sobre as distribuições do Linux mais modernas, inclusive o Amazon Linux, execute o seguinte comando `journald`:

```
journalctl -e SYSLOG_IDENTIFIER=mount-s3
```

Em outros sistemas Linux, as entradas `syslog` provavelmente são gravadas em um arquivo como `/var/log/syslog`.

Você pode usar esses logs para solucionar problemas da aplicação. Por exemplo, se a aplicação tentar sobrescrever um arquivo existente, a operação falhará, e você verá uma linha semelhante à seguinte no log:

```
[WARN] open{req=12 ino=2}: mountpoint_s3::fuse: open failed: inode error: inode 2 (full key "README.md") is not writable
```

Para receber mais informações, consulte [Registro em log](https://github.com/awslabs/mountpoint-s3/blob/main/doc/LOGGING.md) do Mountpoint para Amazon S3 no GitHub.