Como faço para montar, desmontar, montar automaticamente e montar on-premises meu sistema de arquivos do Amazon EFS?

Resolução

Montar um sistema de arquivos

Para montar seu sistema de arquivos do EFS, você pode instalar o pacote amazon-efs-utils. Ou instale o pacote nfs-utils do site da Mankier.

Use amazon-efs-utils

Conclua as etapas a seguir:

1. Para instalar o pacote amazon-efs-utils, execute um dos seguintes comandos com base na sua distribuição:
   Amazon Linux 1, Amazon Linux 2 e Amazon Linux 2023

   $ sudo yum install -y amazon-efs-utils

   Distribuições baseadas em Ubuntu e Debian

   $ sudo apt-get update
   $ sudo apt-get -y install git binutils rustc cargo pkg-config libssl-dev
   $ git clone https://github.com/aws/efs-utils
   $ cd efs-utils
   $ ./build-deb.sh
   $ sudo apt-get -y install ./build/amazon-efs-utils*deb

   Se sua distribuição não fornecer um pacote de ferrugem ou carga, ou fornecer versões anteriores à 1.70, use rustup para instalar rust e cargo:

   'curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   . "$HOME/.cargo/env"

   Para criar e instalar um RPM, execute um dos seguintes comandos com base na sua distribuição:
   OpenSUSE ou SLES

   $ sudo zypper refresh
   $ sudo zypper install -y git rpm-build make rust cargo openssl-devel
   $ git clone https://github.com/aws/efs-utils
   $ cd efs-utils
   $ make rpm
   $ sudo zypper --no-gpg-checks install -y build/amazon-efs-utils*rpm

   Todas as outras distribuições

   $ sudo yum -y install git rpm-build make rust cargo openssl-devel
   $ git clone https://github.com/aws/efs-utils
   $ cd efs-utils  
   $ make rpm
   $ sudo yum -y install build/amazon-efs-utils*rpm

2. Abra o console do Amazon EFS.

3. No painel de navegação, escolha Sistemas de arquivos.

4. Selecione seu sistema de arquivos.

5. Escolha Anexar.

6. Use o SSH ou o Gerenciador de sessões, um recurso do AWS Systems Manager, para se conectar à instância. Execute os seguintes comandos:

   $ sudo mkdir -p /mnt/efs
   $ sudo mkdir -p /mnt/efs-ap
   $ sudo mount -t efs -o tls fs-12345678:/ /mnt/efs
   $ sudo mount -t efs -o tls,accesspoint=fsap-12345678 fs-01233210 /mnt/efs-ap

   Observação: substitua todos os valores de exemplo pelos seus valores.

Use nfs-utils

Conclua as etapas a seguir:

1. Para instalar o pacote nfs-utils, execute um dos seguintes comandos com base na sua distribuição:
   Distribuições baseadas em RHEL e CentOS

   $ sudo yum -y install nfs-utils

   Distribuições baseadas em Ubuntu

   $ sudo apt install nfs-common

2. Abra o console do Amazon EFS.

3. No painel de navegação, escolha Sistemas de arquivos.

4. Selecione seu sistema de arquivos.

5. Escolha Anexar.

6. Use o SSH ou o Gerenciador de sessões para se conectar à instância e, em seguida, execute o seguinte comando:

   $ sudo mkdir -p /mnt/efs
   $ sudo mount -t nfs -o nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport mount-target-DNS:/   ~/efs-mount-point

   -or-
   Para usar um endereço IP para montar, execute o seguinte comando:

   $ sudo mount -t nfs4 -o nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport mount-target-ip:/  ~/efs-mount-point

   Observação: substitua todos os valores de exemplo pelos seus valores.

Desmontar um sistema de arquivos

Para desmontar um sistema de arquivos, execute o seguinte comando:

$ umount /mnt/efs

Se o ponto de montagem estiver ocupado, execute o comando umount com o parâmetro -l:

$ umount -l /mnt/efs

Use /etc/fstab para montar automaticamente um sistema de arquivos

Para criar uma entrada em /etc/fstab para que a montagem do Amazon EFS persista na reinicialização, execute os seguintes comandos:

# vim /etc/fstab

Use amazon-efs-utils

fs-########:/ /mnt/efs efs _netdev,nofail,noresvport,tls,iam 0 0

Use nfs-utils

Configure seus parâmetros no fstab:

fs-########.efs.REGION.amazonaws.com:/ /mnt/efs nfs4 defaults,_netdev,nofail 0 0
# mount -a

Para opções de montagem que usam o auxiliar de montagem, consulte Montagem automática de sistemas de arquivos EFS.

Observação: você pode usar o endereço IP do destino de montagem em uma zona de disponibilidade diferente da do cliente Amazon Elastic Compute Cloud (Amazon EC2) para montar. Esse método de montagem pode gerar cobranças de transferência de dados entre Zonas de disponibilidade e causar latência.

Use o Launch Wizard para montar um sistema de arquivos na inicialização da instância

Ao executar instâncias do Amazon EC2, você pode usar o assistente de inicialização para adicionar automaticamente dados do usuário para montar seu sistema de arquivos.

Conclua as etapas a seguir:

1. Abra o console do Amazon EC2.
2. Selecione Executar instâncias.
3. Selecione uma imagem de máquina da Amazon (AMI — Amazon Machine Image) e um tipo de instância e escolha Avançar: Configurar detalhes da instância.
4. Configure os parâmetros para seu caso de uso. Certifique-se de selecionar a nuvem privada virtual (VPC) e a sub-rede necessárias para a montagem do EFS.
5. Na página Configurar instância, em Sistemas de arquivos, selecione seu sistema de arquivos. O caminho ao lado do ID do sistema de arquivos é o ponto de montagem que a instância do EC2 usa. Você pode alterar esse caminho conforme necessário.
   Para montar seu sistema de arquivos, os dados do usuário são gerados automaticamente na seção Detalhes avançados:

   #cloud-config
   package_update: true
   package_upgrade: true
   runcmd:
   - yum install -y amazon-efs-utils
   - apt-get -y install amazon-efs-utils
   - yum install -y nfs-utils
   - apt-get -y install nfs-common
   - file_system_id_1=fs-0cae1679a766bcf49
   - efs_mount_point_1=/mnt/efs/fs1
   - mkdir -p "${efs_mount_point_1}"
   - test -f "/sbin/mount.efs" && printf "\n${file_system_id_1}:/ ${efs_mount_point_1} efs tls,_netdev\n" >> /etc/fstab || printf "\n${file_system_id_1}.efs.us-east-1.amazonaws.com:/ ${efs_mount_point_1} nfs4 nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport,_netdev 0 0\n" >> /etc/fstab
   - test -f "/sbin/mount.efs" && grep -ozP 'client-info]\nsource' '/etc/amazon/efs/efs-utils.conf'; if [[ $? == 1 ]]; then printf "\n[client-info]\nsource=liw\n" >> /etc/amazon/efs/efs-utils.conf; fi;
   - retryCnt=15; waitTime=30; while true; do mount -a -t efs,nfs4 defaults; if [ $? = 0 ] || [ $retryCnt -lt 1 ]; then echo File system mounted successfully; break; fi; echo File system not available, retrying to mount.; ((retryCnt--)); sleep $waitTime; done;>

   -or-
   Para montar um sistema de arquivos do Amazon EFS em uma AMI personalizada ou com opções específicas, execute os seguintes comandos para adicionar dados personalizados do usuário:
   Distribuições baseadas em RHEL e CentOS

   #!/bin/bash
   sudo mkdir -p /mnt/efs
   sudo yum -y install nfs-utils

   Distribuições baseadas em Ubuntu

   #!/bin/bash
   sudo mkdir -p /mnt/efs
   sudo apt install nfs-common
   sudo mount -t nfs4 -o nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport mount-target-ip:/ /mnt/efs

   Para obter mais informações, consulte Executar comandos ao iniciar uma instância do EC2 com entrada de dados do usuário.
6. Executar a instância.

Monte um sistema de arquivos on-premises

Para montar um sistema de arquivos do Amazon EFS em seus servidores on-premises, deve haver conectividade entre o Amazon EFS e os servidores on-premises. Para estabelecer conectividade entre o servidor on-premises e a Amazon Virtual Private Cloud (Amazon VPC), use o AWS Direct Connect e o AWS VPN. Em seguida, execute os seguintes comandos para instalar o cliente NFS e montar seu sistema de arquivos:

$ sudo yum -y install nfs-utils (Red Hat Linux)
$ sudo apt-get -y install nfs-common (Ubuntu)
$ mkdir ~/efs
$ sudo mount -t nfs -o nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport mount-target-IP:/ ~/efs

Para obter mais informações, consulte Tutorial: Montagem com clientes Linux on-premises.