Mover um IDE do AWS Cloud9 em volumes do Amazon EBS

Para mover um ambiente

1. (Opcional) Se o tipo de instância requer drivers que não estão instalados na instância atual, conecte-se à sua instância e instale os drivers primeiro. Para obter mais informações, consulte Compatibility for resizing instances no Manual do usuário do Amazon EC2.

2. Feche todas as guias do navegador da Web que estiverem exibindo o ambiente atualmente.

   Importante

   Se você não fechar todas as guias do navegador da web que estiverem atualmente exibindo o ambiente, o AWS Cloud9 poderá interferir na conclusão do procedimento. Especificamente, o AWS Cloud9 poderá tentar reiniciar a instância do Amazon EC2 associada ao ambiente, em um momento inadequado durante o procedimento. A instância deve permanecer interrompida até a última etapa nesse procedimento.

3. Faça login no AWS Management Console, se ainda não estiver conectado, em https://console.aws.amazon.com.

   Recomendamos que você faça login usando as credenciais de um administrador em sua Conta da AWS. Se isso não for possível, fale com o administrador de sua Conta da AWS.

4. Abra o console do Amazon EC2. Para fazer isso, na lista de Services (Serviços), selecione EC2.

5. Na barra de navegação da AWS, selecione a Região da AWS que contém o ambiente que você deseja mover (por exemplo, US East (Ohio) [Leste dos EUA (Ohio)].

6. No painel de navegação do serviço, expanda Instances (Instâncias) se ainda não estiver expandida e, em seguida, selecione Instances (Instâncias).

7. Na lista de instâncias, selecione aquela que estiver associada ao ambiente que você quiser mover. Para um ambiente EC2, a instância começa com o aws-cloud9-, seguido pelo nome do ambiente. Por exemplo, se o nome do ambiente for my-demo-environment, o nome da instância começará com aws-cloud9-my-demo-environment.

8. Se o Estado da instância não for Interrompido, selecione Ações, Estado da instância, Interromper. Quando solicitado, selecione Yes, Stop (Sim, interrompa). Pode demorar alguns minutos para que a instância pare.

9. Depois que o Instance State (Estado da instância) for interrompido, selecione Actions (Ações), Instance settings (Configurações da instância) e Change Instance Type (Alterar o tipo de instância).

10. Na caixa de diálogo Change Instance Type (Alterar tipo de instância), escolha o novo Instance Type (Tipo de instância), que você deseja que o ambiente use.

    nota

    Se o tipo de instância desejado não aparece na lista, ele não é compatível com a configuração da instância. Por exemplo, a instância pode não ser compatível devido ao tipo de virtualização.

11. (Opcional) Se o tipo de instância selecionado oferecer suporte a otimização para EBS, selecione EBS-optimized (Otimizado para EBS) ou cancele a seleção de EBS-optimized (Otimizado para EBS) para desabilitar a otimização para EBS.

    nota

    Se, por padrão, o tipo de instância selecionado for otimizado para EBS, a opção EBS-optimized (Otimizado para EBS) estará selecionada e você não poderá cancelar essa seleção.

12. Escolha Apply para aceitar as novas configurações.

    nota

    Se você não escolheu um tipo de instância diferente para Instance Type (Tipo de instância) anteriormente neste procedimento, nada acontecerá depois que você selecionar Apply (Aplicar).

13. Reabra o ambiente. Para ter mais informações, consulte Abrir um ambiente no AWS Cloud9.

Como mover um ambiente baixando o arquivo em uma máquina local

1. Crie um ambiente na mesma zona de disponibilidade com uma imagem de base diferente:

   1. Conclua as etapas na seção Criar um ambiente EC2 para criar um ambiente.

      nota

      Ao escolher a Plataforma, selecione aquela para a qual você deseja migrar seu ambiente.

   2. Por padrão, os ambientes são criados com volume de 10 GiB. Se você não tiver espaço suficiente para carregar ou descompactar o arquivo no novo ambiente, conclua as etapas do procedimento Redimensionar um volume do Amazon EBS usado por um ambiente para redimensionar o tamanho do volume do Amazon EBS.

2. Abra o ambiente que você deseja migrar no IDE AWS Cloud9.

3. Depois que o IDE AWS Cloud9 carregar, selecione Arquivo > Baixar projeto no menu para baixar o arquivo com o conteúdo do diretório do projeto do ambiente.

4. Abra o IDE AWS Cloud9 no novo ambiente.

5. Escolha Arquivo > Carregar arquivos locais... para carregar o arquivo.

6. (Opcional) Para fazer backup do diretório .c9 antigo para .c9.backup, no terminal do ambiente, execute o seguinte comando:

   cp .c9 .c9.backup

   Você pode precisar desses arquivos de backup se quiser restaurar os arquivos de configuração posteriormente.

7. Para descompactar o arquivo, execute o seguinte comando:

   tar xzvf <old_environment_name>.tar.gz -C ~/

8. Para excluir o arquivo do diretório do projeto, execute o seguinte comando:

   rm <old_environment_name>.tar.gz

   Verifique se o novo ambiente funciona conforme o esperado.

9. Agora você pode excluir o ambiente antigo.

Como mover um ambiente usando um volume do Amazon EBS

Se não conseguir baixar o arquivo ou se o arquivo resultante for muito grande, você pode usar o volume do Amazon EBS para migrar. Além disso, esse método permite copiar arquivos que estão localizados fora do diretório ~/environment.

1. Feche todas as guias do IDE AWS Cloud9 que estão abertas no ambiente existente.

2. Conclua as seguintes etapas para interromper a instância existente:

   1. No console do AWS Cloud9, selecione o ambiente para navegar e visualizar os respectivos detalhes.

   2. Na página Detalhes do ambiente, na guia Instância do EC2, escolha Gerenciar instância do EC2.

   3. No console do EC2, selecione a instância para navegar até os detalhes da instância.

   4. Observe que Estado da instância deve estar definido como Interrompido. Caso contrário, selecione Interromper instância na lista suspensa Estado da instância. Quando solicitado, selecione Interromper. Pode demorar alguns minutos para que a instância pare.

3. Crie um ambiente na mesma zona de disponibilidade com uma imagem de base diferente:

   1. Conclua as etapas na seção Criar um ambiente EC2 para criar um ambiente.

      nota

      Ao escolher a Plataforma, selecione aquela para a qual você deseja migrar seu ambiente.

   2. Por padrão, os ambientes são criados com volume de 10 GiB. Se você não tiver espaço suficiente para mover arquivos do volume de origem para o novo ambiente, conclua as etapas do procedimento Redimensionar um volume do Amazon EBS usado por um ambiente para redimensionar o tamanho do volume do Amazon EBS.

4. Conclua as seguintes etapas para desanexar o volume da instância existente:

   1. Na página Resumo da instância, escolha a guia Armazenamento e selecione o volume. O nome do dispositivo do volume selecionado deve ser o mesmo especificado em Nome do dispositivo raiz da seção Detalhes de dispositivo raiz.

   2. Na página de detalhes do volume, escolha Ações > Desanexar volume.

   3. Depois que o volume for desanexado com sucesso, escolha Ações > Anexar volume e, em seguida, localize e selecione a instância do novo ambiente na lista suspensa. O nome da instância do Amazon EC2 que você selecionar deve conter o nome do ambiente do AWS Cloud9 prefixado com aws-cloud9.

5. Abra o IDE AWS Cloud9 no novo ambiente.

6. Depois que o ambiente tiver sido carregado, para identificar o dispositivo do volume recém-anexado, execute o seguinte comando no terminal:

   lsblk

   No exemplo de saída a seguir, a partição nvme0n1 do dispositivo raiz nvme0n1p1 já está montada, portanto, a partição nvme1n1p1 também deve estar montada. O caminho completo para o dispositivo é /dev/nvme1n1p1:

   Admin:~/environment $ lsblk
   NAME          MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS
   nvme0n1       259:0    0  10G  0 disk 
   ├─nvme0n1p1   259:2    0  10G  0 part /
   ├─nvme0n1p127 259:3    0   1M  0 part 
   └─nvme0n1p128 259:4    0  10M  0 part /boot/efi
   nvme1n1       259:1    0  10G  0 disk 
   ├─nvme1n1p1   259:5    0  10G  0 part 
   └─nvme1n1p128 259:6    0   1M  0 part 

   nota

   A saída varia ao executar esse comando no terminal.

7. Conclua as seguintes etapas no terminal do ambiente para montar o volume existente:

   1. Para criar um diretório temporário no qual a partição do volume será montada, execute o seguinte comando:

      MOUNT_POINT=$(mktemp -d)

   2. Com base no exemplo de saída do comando lsblk, especifique o seguinte caminho do dispositivo a ser montado:

      MOUNT_DEVICE=/dev/nvme1n1p1

      nota

      A saída varia ao executar esse comando no terminal.

   3. Para montar o volume existente, execute o seguinte comando:

      sudo mount $MOUNT_DEVICE $MOUNT_POINT

   4. Conclua as seguintes etapas para verificar se o volume existente está montado corretamente:

      1. Para garantir que o volume está incluído na saída, execute o seguinte comando:

         df -h

      2. Para verificar o conteúdo do volume, execute o seguinte comando:

         ls $MOUNT_POINT/home/ec2-user/environment/

8. (Opcional) Para fazer backup do diretório .c9 antigo para .c9.backup, no terminal do ambiente, execute o seguinte comando:

   cp .c9 .c9.backup

   Você pode precisar desses arquivos de backup se quiser restaurar os arquivos de configuração posteriormente.

9. Para copiar o ambiente antigo no volume existente, execute o seguinte comando:

   cp -R $MOUNT_POINT/home/ec2-user/environment ~

   nota

   Se for necessário, você também poderá copiar arquivos ou diretórios fora do diretório do ambiente usando o comando anterior.

   Verifique se o novo ambiente funciona conforme o esperado.

10. Para desmontar o dispositivo anterior, execute um dos dois comandos abaixo:

    sudo umount $MOUNT_DEVICE

    sudo umount $MOUNT_POINT

11. Escolha Desanexar volume na lista suspensa Ações para separar o volume que você anexou na Etapa 3.

12. Agora você pode excluir o ambiente antigo e o respectivo volume.

    nota

    Como o volume não está mais conectado à instância do Amazon EC2 do ambiente, você precisará removê-lo manualmente. Você pode fazer isso escolhendo Excluir na página Detalhes do volume.