Solução de problemas de AWS Cloud9 - AWS Cloud9

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas de AWS Cloud9

Use as informações a seguir para identificar e resolver problemas com o AWS Cloud9.

Se o problema não estiver listado, ou se você precisar de mais ajuda, consulte o Fórum de discussão do AWS Cloud9. Ao entrar nesse fórum, pode ser que você precise fazer login. Você também pode entrar em contato conosco diretamente.

Installer (Instalador)

A seção a seguir descreve a solução de problemas relacionados ao instalador do AWS Cloud9.

O instalador do AWS Cloud9 trava ou falha

Problema: ao baixar e executar o instalador do AWS Cloud9, uma ou mais mensagens de erro são exibidas, e o script do instalador não mostra Done.

Causa: o instalador do AWS Cloud9 encontrou um ou mais erros dos quais não consegue se recuperar e, portanto, ocorre uma falha.

Solução: para obter mais informações, consulte Solução de problemas do instalador do AWS Cloud9. Consulte os problemas comuns, as possíveis causas e as soluções recomendadas.

O instalador do AWS Cloud9 não é encerrado depois de exibir: "Package Cloud9 IDE 1" (Pacote Cloud9 IDE)

Problema: o AWS Cloud9 é instalado em sua instância do Amazon EC2 existente ou em seu próprio servidor, como parte do processo de criação de um ambiente de desenvolvimento SSH. A instalação é interrompida depois de você receber esta mensagem na caixa de diálogo do Instalador do AWS Cloud9: “Pacote Cloud9 IDE 1”. Se você escolher Cancelar, verá a seguinte mensagem: “Falha na instalação.“ Esse erro ocorre quando os pacotes do AWS Cloud9 não podem ser instalados no host SSH do cliente.

Causa: um host SSH exige que você tenha o Node.js instalado. Recomendamos instalar a versão Node.js mais recente compatível com o sistema operacional do host. Se você tiver uma versão do Node.js em seu host que não seja compatível com o AWS Cloud9, poderá ocorrer um erro de instalação.

Solução recomendada: instale uma versão do Node.js compatível com o AWS Cloud9 no seu host SSH.

Falha ao instalar as dependências

Problema: o AWS Cloud9 precisa de acesso à Internet para baixar as dependências.

Causas possíveis:

  • Se o seu ambiente do AWS Cloud9 estiver usando um proxy para acessar a Internet, o AWS Cloud9 precisará dos detalhes do proxy para instalar as dependências. Se você não forneceu os detalhes de seu proxy para o AWS Cloud9, esse erro será exibido.

  • Outra causa disso pode ser se seu ambiente não permitir tráfego de saída.

Soluções recomendadas:

  • Para fornecer os detalhes do proxy ao AWS Cloud9, anexe o seguinte ao arquivo ~/.bashrc do ambiente:

    export http_proxy=[proxy url for http] export https_proxy=[proxy url for https] #Certificate Authority used by your proxy export NODE_EXTRA_CA_CERTS=[path_to_pem_certificate]

    Por exemplo, se o URL do proxy HTTP for https://172.31.26.80:3128 e seu URL de proxy HTTP forhttps://172.31.26.80:3129, adicione as linhas a seguir ao seu arquivo ~/.bashrc e defina NODE_EXTRA_CA_CERTS o caminho de um arquivo de autoridade de certificação no formato PEM. Para obter mais informações sobre essa variável, consulte https://nodejs.org/api/cli.html#node_extra_ca_certsfile.

    export http_proxy=http://172.31.26.80:3128 export https_proxy=https://172.31.26.80:3129 export NODE_EXTRA_CA_CERTS=[path_to_pem_certificate]
  • Se você estiver usando uma instância do Amazon EC2 sem entrada, você deve garantir que um endpoint do Amazon VPC para o Amazon S3 esteja configurado. Para obter mais informações sobre isso, consulte Configurar VPC endpoints do Amazon VPC endpoints para dependências de download do Amazon S3.

Erro do ambiente SSH: “É necessário o Python versão 3 para instalar o pty.js”

Problema: após abrir um ambiente de desenvolvimento SSH do AWS Cloud9, o terminal no IDE do AWS Cloud9 exibe uma mensagem que começa com “É necessário o Python versão 3 para instalar o pty.js”.

Causa: para funcionar como esperado, um ambiente SSH requer que o Python versão 3 esteja instalado.

Solução: instale o Python versão 3 no ambiente. Para verificar a versão, a partir do terminal do servidor, execute o comando python --version . Para instalar o Python 3 no servidor, consulte um dos seguintes:

Ambiente do AWS Cloud9

A seção a seguir descreve a solução de problemas relacionados ao ambiente AWS Cloud9.

Erro de criação do ambiente: "We are unable to create EC2 instances..." (Não foi possível criar instâncias do EC2...)

Problema: quando você tenta criar um ambiente de desenvolvimento do AWS Cloud9, uma mensagem será exibida com a frase "Não foi possível criar instâncias do EC2 na sua conta durante a verificação e ativação da conta."

Causa: a AWS está verificando e ativando sua Conta da AWS. Enquanto a ativação não for concluída, o que pode levar até 24 horas, não será possível criar esse nem outros ambientes.

Solução: tente criar o ambiente novamente mais tarde. Se você ainda estiver recebendo essa mensagem após 24 horas, entre em contato com o suporte. Além disso, é importante saber que, mesmo quando ocorre uma falha em uma tentativa de criar um ambiente, o AWS CloudFormation cria uma pilha relacionada em sua conta. Essas pilhas são contabilizadas na cota de criação de pilhas de sua conta. Para não esgotar o limite de criação de pilhas, é possível excluir com segurança essas pilhas com falha. Para obter mais informações, consulte Excluir uma pilha no console do AWS CloudFormation no Manual do usuário do AWS CloudFormation.

Erro de criação do ambiente: "Not authorized to perform sts:AssumeRole" (Não autorizado a realizar sts:AssumeRole)

Problema: quando você tenta criar um ambiente, o seguinte erro é exibido: “Not authorized to perform sts:AssumeRole” (Não autorizado a realizar sts:AssumeRole), e o ambiente não é criado.

Possíveis causas: não existe uma função vinculada ao serviço AWS Cloud9 em sua Conta da AWS.

Soluções recomendadas: crie uma função vinculada a serviços do AWS Cloud9 em sua Conta da AWS. Você pode fazer isso executando o comando a seguir na AWS Command Line Interface (AWS CLI) ou no AWS CloudShell.

aws iam create-service-linked-role --aws-service-name cloud9.amazonaws.com # For the AWS CLI. iam create-service-linked-role --aws-service-name cloud9.amazonaws.com # For the aws-shell.

Se isso não for possível, fale com o administrador de sua Conta da AWS.

Depois de executar esse comando, tente criar o ambiente novamente.

Identidades federadas não podem criar ambientes

Problema: ao tentar usar uma identidade federada da AWS para criar um AWS Cloud9, uma mensagem de erro de acesso é exibida, e o ambiente não é criado.

Causa: o AWS Cloud9 usa funções vinculadas ao serviço. A função vinculada ao serviço é criada na primeira vez em que um ambiente é criado em uma conta usando a chamada iam:CreateServiceLinkedRole. No entanto, os usuários federados não podem chamar as APIs do IAM. Para obter mais informações, consulte GetFederationToken na Referência da API do AWS Security Token Service

Solução: peça a um administrador da Conta da AWS para criar a função vinculada ao serviço para o AWS Cloud9 no console do IAM ou executando esse comando com a AWS Command Line Interface (AWS CLI):

aws iam create-service-linked-role --aws-service-name cloud9.amazonaws.com

Ou esse comando com o AWS-shell:

iam create-service-linked-role --aws-service-name cloud9.amazonaws.com

Para obter mais informações, consulteUso de funções vinculadas ao serviço no Guia do usuário do IAM.

Erro do console: "O usuário não está autorizado a realizar a ação no recurso"

Problema: ao tentar usar o console do AWS Cloud9 para criar ou gerenciar um ambiente de desenvolvimento do AWS Cloud9, você vê um erro que contém uma frase semelhante a “O usuário arn:aws:iam::123456789012:user/MyUser não tem autorização para executar cloud9:action no recurso arn:aws:cloud9:us-east-2:123456789012:environment:12a34567b8cd9012345ef67abcd890e1”, em que:

  • arn:aws:iam::123456789012:user/MyUser é o nome de recurso da Amazon (ARN) do usuário solicitante.

  • action é o nome da operação que o usuário solicitou.

  • arn:aws:cloud9:us-east-2:123456789012:environment:12a34567b8cd9012345ef67abcd890e1 é o ARN do ambiente solicitado pelo usuário para executar a operação.

Causa: o usuário com o qual você fez login no console do AWS Cloud9 não tem as permissões de acesso corretas da AWS para executar a ação.

Solução: garanta que o usuário tenha as permissões de acesso corretas da AWS e tente executar a ação novamente. Para ver mais informações, consulte:

Não é possível estabelecer conexão com um ambiente

Problema: os usuários não conseguem se conectar a um ambiente e estão parados no estágio de conexão.

Causa: se você alterar as permissões do arquivo ~/ .ssh/authorized_keys, remover as chaves do AWS Cloud9 desse arquivo ou remover o arquivo por completo, esse problema poderá ocorrer.

Solução: não exclua esse arquivo. Se você o excluir, deverá recriar seu ambiente e talvez precise anexar o volume do EBS de um ambiente existente ao novo ambiente do EC2. O objetivo é recuperar os dados perdidos. Se faltarem permissões, verifique se o arquivo tem permissões Read-Write. O objetivo é permitir que o daemon SSH o leia.

Não é possível abrir um ambiente

Problema: ao tentar abrir um ambiente, o IDE não é exibido além de cinco minutos.

Causas possíveis:

  • O usuário do IAM que está conectado ao console do AWS Cloud9 não tem as permissões de acesso da AWS necessárias para abrir o ambiente.

  • Se o ambiente estiver associado a uma instância de computação em nuvem da AWS (por exemplo, uma instância do Amazon EC2), poderá estar ocorrendo o seguinte:

    • A VPC associada à instância não está definida com as configurações corretas para o AWS Cloud9.

    • A instância está em transição entre estados ou está apresentando falhas nas verificações de status automatizadas enquanto o AWS Cloud9 está tentando se conectar à instância.

  • Se for um ambiente SSH, a instância de computação em nuvem associada ou seu próprio servidor não será configurado corretamente para permitir que o AWS Cloud9 o acesse.

Soluções recomendadas:

  • Verifique se o usuário do IAM que está conectado ao console do AWS Cloud9 tem as permissões de acesso da AWS necessárias para abrir o ambiente. Depois, tente abrir o ambiente novamente. Para obter mais informações, consulte o seguinte ou fale com o administrador da Conta da AWS:

    Se o usuário do IAM conectado ainda não conseguir abrir o ambiente, tente sair e entrar novamente como o usuário raiz da Conta da AWS ou como um usuário administrador na conta. Depois, tente abrir o ambiente novamente. Se você não conseguir abrir o ambiente dessa forma, é provável que haja um problema com as permissões de acesso do usuário do IAM.

  • Se o ambiente estiver associado a uma instância de computação em nuvem da AWS (por exemplo, uma instância do Amazon EC2), faça o seguinte:

    • Garanta que a VPC associada à instância esteja definida corretamente para o AWS Cloud9 e tente abrir o ambiente novamente. Para obter mais informações, consulte Requisitos da Amazon VPC para o AWS Cloud9.

      Se a VPC associada à instância de computação em nuvem da AWS estiver definida corretamente para o AWS Cloud9 e ainda não for possível abrir o ambiente, é provável que o grupo de segurança da instância esteja impedindo o acesso ao AWS Cloud9. Somente como uma técnica de solução de problemas, verifique o grupo de segurança para garantir que no mínimo, o tráfego SSH de entrada está permitido pela porta 22 para todos os endereços IP (Anywhere ou 0.0.0.0/0). Para obter instruções, consulte Describing Your Security Groups (Descrever grupos de segurança) e Updating Security Group Rules (Atualizar regras do grupo de segurança) no Manual do usuário do Amazon EC2 para instâncias do Linux.

      Para saber as etapas adicionais de solução de problemas da VPC, assista a um vídeo de cinco minutos sobre isso, em AWS Knowledge Center Videos: What can I check if I cannot connect to an instance in a VPC? (Vídeos da Central de Conhecimento da : O que posso conferir se não conseguir me conectar a uma instância em uma VPC?), no YouTube.

      Atenção

      Quando finalizar a solução de problemas, defina as regras de entrada como um intervalo de endereços apropriado. Para obter mais informações, consulte Intervalos de endereços IP SSH de entrada para o AWS Cloud9.

    • Reinicie a instância, verifique se ela está em execução e se passou em todas as verificações do sistema. Depois, tente abrir o ambiente novamente. Para obter mais informações, consulte Reinicializar a instância e Visualizar verificações de status no Manual do usuário do Amazon EC2 para instâncias do Linux.

  • Se for um ambiente SSH, verifique se a instância de computação em nuvem associada a ele ou seu próprio servidor está configurado corretamente para permitir que o AWS Cloud9 o acesse. Depois, tente abrir o ambiente novamente. Para obter mais informações, consulte Requisitos de host do ambiente SSH.

Não é possível abrir o ambiente do AWS Cloud9: “Este ambiente não pode ser acessado atualmente por colaboradores. Aguarde até que a remoção das credenciais temporárias gerenciadas esteja concluída ou entre em contato com o proprietário deste ambiente."

Problema: quando um novo colaborador é adicionado a um ambiente por alguém que não seja o proprietário dele, as credenciais temporárias gerenciadas pela AWS são desabilitadas. As credenciais são desabilitadas quando você exclui o arquivo ~/.aws/credentials. Enquanto a exclusão do arquivo ~/.aws/credentials estiver em andamento, os novos colaboradores não poderão acessar o ambiente do AWS Cloud9.

Causa: impedir o acesso ao ambiente durante a exclusão de credenciais temporárias gerenciadas pela AWS é uma medida de segurança. Isso permite que os proprietários de ambiente confirmem que apenas os colaboradores confiáveis têm acesso a credenciais gerenciadas. Se estiverem convencidos de que a lista de colaboradores é válida, os proprietários do ambiente poderão reativar as credenciais gerenciadas para que possam ser compartilhadas. Para obter mais informações, consulte Controlar o acesso às credenciais temporárias gerenciadas pela AWS.

Soluções recomendadas: aguarde até que o arquivo ~/.aws/credentials seja totalmente excluído para tentar abrir novamente o ambiente do AWS Cloud9. O tempo máximo de espera para a expiração das credenciais é de 15 minutos. Como alternativa, peça ao proprietário do ambiente para reativar ou desativar as credenciais temporárias gerenciadas. Depois que as credenciais forem reativadas ou desabilitadas, os colaboradores poderão acessar imediatamente o ambiente. Ao alternar o estado das credenciais gerenciadas para ENABLED ou DISABLED (Habilitada ou Desabilitada), o proprietário do ambiente garante que as credenciais não permaneçam em um estado intermediário. Um estado intermediário pode impedir que os colaboradores acessem o ambiente.

nota

Suponha que o proprietário e o colaborador do ambiente pertençam à mesma Conta da AWS. Depois, o proprietário poderá identificar o proprietário do ambiente a ser contatado analisando o cartão para um ambiente na página Your environments (Seus ambientes) no console. O proprietário do ambiente também está listado na página Environment details (Detalhes do ambiente).

Erro de exclusão do ambiente: “One or more failed to delete’’ (Falha na exclusão de um ou mais ambientes)

Problema: quando você tenta excluir um ou mais ambientes no console do AWS Cloud9, uma mensagem é exibida informando “one or more environments failed to delete” (falha na exclusão de um ou mais ambientes), e pelo menos um dos ambientes não é excluído.

Causa possível: o AWS CloudFormation pode enfrentar problemas para excluir um ou mais ambientes. O AWS Cloud9 depende do AWS CloudFormation para criar e excluir ambientes.

Solução recomendada: tente usar o AWS CloudFormation para excluir cada um dos ambientes não excluídos.

  1. Abra o console do AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

  2. Na barra de navegação da AWS, selecione a Região da AWS do ambiente.

  3. Na lista de pilhas do AWS CloudFormation, selecione a entrada em que Stack name (Nome da pilha) contenha o nome do ambiente não excluído, e o Status seja DELETE_FAILED. Por exemplo, se o nome do ambiente for my-demo-environment, escolha a pilha que começa com o nome aws-cloud9-my-demo-environment. (Escolha a caixa ou a opção ao lado do nome do ambiente e não o nome do ambiente em si).

  4. Escolha Actions, Delete Stack (Ações, excluir pilha).

  5. Se solicitado, escolha Yes, delete (Sim, excluir).

O processo de exclusão de uma pilha pode demorar alguns minutos.

Se a pilha desaparecer da lista, o ambiente agora estará excluído.

Se a pilha ainda for exibida com DELETE_FAILED depois de alguns minutos, isso significa que o ambiente ainda não foi excluído. Você pode tentar excluir manualmente cada um dos recursos da pilha com falha.

nota

A exclusão manual de recursos de uma pilha com falha não remove a própria pilha da Conta da AWS.

Para excluir manualmente esses recursos, faça o seguinte. No console do AWS CloudFormation, escolha a pilha com falha e selecione a seção Resources (Recursos). Acesse o console na AWS de cada recurso nessa lista e, depois, use o console para excluir o recurso.

Alterando o tempo limite de tempo para um ambiente no IDE AWS Cloud9

Problema: os usuários querem atualizar o tempo limite dos ambientes Amazon EC2.

Causa: O tempo limite padrão é de 30 minutos. Isso pode ser muito curto para alguns usuários.

A solução recomendada:

  1. Abra o ambiente que você deseja configurar.

  2. No IDE do AWS Cloud9, na barra de menus, selecione AWS Cloud9 Preferences.

  3. Na janela Preferências, vá até a seção de instância do Amazon EC2.

  4. Selecione o valor do tempo limite na lista disponível e atualize.

Erro ao executar aplicações SAM localmente no AWS Toolkit porque o AWS Cloud9 não tem espaço em disco suficiente

Problema: ocorre um erro quando você utiliza a função AWS Toolkit para executar comandos da CLI do AWS SAM para aplicações definidas por modelos do SAM.

Causas possíveis: quando você executa e depura aplicações sem servidor localmente com o kit de ferramentas da AWS, o AWS SAM usa imagens do Docker. Essas imagens fornecem um ambiente de tempo de execução e ferramentas de compilação que emulam o ambiente do Lambda no qual você está planejando implantar.

Porém, se o ambiente não tiver espaço em disco suficiente, a imagem do Docker que fornece esses recursos não conseguirá compilar e a aplicação SAM local não será executada. Se isso ocorrer, você poderá receber um erro na guia Output (Resultado) semelhante ao seguinte.

Error: Could not find amazon/aws-sam-cli-emulation-image-python3.7:rapid-1.18.1 image locally and failed to pull it from docker.

Esse erro refere-se a uma aplicação SAM que é construída usando o tempo de execução Python. Você poderá receber uma mensagem um pouco diferente, dependendo do tempo de execução selecionado para sua aplicação.

Soluções recomendadas: libere espaço em disco no seu ambiente para que a imagem do Docker possa ser compilada. Remova todas as imagens do Docker não utilizadas executando o seguinte comando no terminal do IDE:

docker image prune -a

Se você estiver tendo problemas com comandos da CLI do SAM repetidamente, em virtude de restrições de espaço em disco, alterne para um ambiente de desenvolvimento que use outro tipo de instância.

(Voltar ao início)

Não é possível carregar o IDE usando versões mais antigas do navegador Microsoft Edge

Problema: erro HTTP403: FORBIDDEN é retornado ao tentar carregar o IDE do AWS Cloud9 usando o navegador da web Microsoft Edge.

Causas possíveis: o IDE do AWS Cloud9 não oferece suporte a certas versões mais antigas do Microsoft Edge.

Soluções recomendadas: para atualizar o navegador, escolha o botão de reticências (...) na barra de ferramentas do Microsoft Edge. No menu, selecione Configurações e Sobre o Microsoft Edge. Se uma atualização for necessária, ela será baixada e instalada automaticamente.

(Voltar ao início)

Não é possível criar a estrutura de subpastas /home/ec2-user/environment/home/ec2-user/environment no explorador de arquivos do IDE do AWS Cloud9.

Problema: ao criar a estrutura de subpastas /home/ec2-user/environment/home/ec2-user/environment no explorador de arquivos do IDE do AWS Cloud9, você recebe uma mensagem de erro informando que não é possível abrir esse diretório.

Causas possíveis: no momento, não é possível criar uma estrutura de subpastas /home/ec2-user/environment em uma pasta com o mesmo nome usando o sistema de arquivos do IDE do AWS Cloud9. Você não poderá acessar nenhum arquivo dentro desse diretório pelo explorador de arquivos do IDE do AWS Cloud9, mas poderá acessá-los usando a linha de comando. Esse problema afeta apenas o caminho de arquivo /home/ec2-user/environment/home/ec2-user/environment; caminhos de arquivo como /test/home/ec2-user/environment e /home/ec2-user/environment/test devem funcionar. Esse é um problema conhecido e afeta somente o File Explorer do IDE do AWS Cloud9.

Soluções recomendadas: use um nome e uma estrutura de arquivo diferentes.

(Voltar ao início)

Não é possível criar a estrutura de subpastas /projects/projects no explorador de arquivos do IDE do AWS Cloud9 para CodeCatalyst.

Problema: quando você cria a estrutura de subpastas /projects/projects no explorador de arquivos do IDE do AWS Cloud9 para CodeCatalyst, você recebe uma mensagem de erro informando que não é possível abrir esse diretório.

Causas possíveis: no momento, não é possível criar uma estrutura de subpastas /projects em uma pasta com o mesmo nome usando o explorador de arquivos do IDE do AWS Cloud9 para CodeCatalyst. Você não poderá acessar nenhum arquivo dentro desse diretório pelo explorador de arquivos do IDE do AWS Cloud9, mas poderá acessá-los usando a linha de comando. Esse problema afeta apenas o caminho do arquivo /projects/projects; caminhos de arquivo como /test/projects e /projects/test/ devem funcionar. Esse é um problema conhecido e afeta somente o explorador de arquivos do IDE do AWS Cloud9 para CodeCatalyst.

Soluções recomendadas: use um nome e uma estrutura de arquivo diferentes.

(Voltar ao início)

Não é possível interagir com a janela do terminal no AWS Cloud9 devido a erros de sessão de tmux

Problema: quando você tenta iniciar uma nova janela de terminal no AWS Cloud9, a interface de linha de comando esperada não está disponível. Não há prompt de comando e você não consegue inserir texto. Mensagens de erro, como tmux: need UTF-8 locale (LC_CTYPE) e invalid LC_ALL, LC_CTYPE or LANG, são retornadas.

Causas possíveis: a falta de resposta de um terminal pode ser causada por um erro de tmux. O AWS Cloud9 usa o utilitário tmux. Dessa forma, as informações exibidas no terminal persistem mesmo quando a página é recarregada ou quando você se reconecta ao ambiente de desenvolvimento.

Em uma sessão tmux, o que é exibido na janela do terminal é tratado por um cliente. O cliente se comunica com um servidor que pode gerenciar várias sessões. O servidor e o cliente se comunicam por meio de um soquete localizado na pasta tmp. Se a pasta tmp estiver faltando no ambiente de desenvolvimento ou permissões excessivamente restritivas forem aplicadas a ela, as sessões de tmux não poderão ser executadas. Se isso ocorrer, a janela do terminal no IDE deixa de responder.

Soluções recomendadas: se os erros de tmux estiverem impedindo a interação com a janela do terminal, use um modo alternativo para criar uma pasta tmp com as permissões adequadas. Dessa forma, as sessões tmux podem ser executadas. Uma solução é exportar LC_CTYPE em .bash_profile ou no arquivo .bashrc. Uma outra solução é usar o AWS Systems Manager para definir uma configuração de gerenciamento do host. Isso permite acesso à instância relevante por meio do console do Amazon EC2.

Configurar o gerenciamento de host

  1. Primeiro, no console do AWS Cloud9, encontre o nome da instância de seu ambiente. É possível fazer isso selecionando o painel relevante na página Your environments (Seus ambientes) e View details (Visualizar detalhes). Na página Detalhes do ambiente, escolha Ir para a instância. No console do Amazon EC2, confirme o nome da instância que você precisa acessar.

  2. Agora vá para o console do AWS Systems Manager e, no painel de navegação, escolha Configuração rápida.

  3. Na página Quick Setup (Configuração rápida), escolha Create (Criar).

  4. Para Configuration types (Tipos de configuração), vá para Host Management (Gerenciamento de host) e escolha Create (Criar).

  5. Para Customize Host Management configuration options (Personalizar opções de configuração de Gerenciamento de Host), na seção Targets (Destinos), escolha Manual.

  6. Selecione a instância do EC2 que você deseja acessar e depois escolha Create (Criar).

Conectar-se à instância e executar comandos

nota

As etapas a seguir se destinam ao novo console do EC2.

  1. No console do Amazon EC2, no painel de navegação, escolha Instâncias e selecione a instância à qual deseja se conectar.

  2. Selecione Conectar.

    Se Connect (Conectar) não estiver ativado, poderá ser necessário iniciar a instância primeiro.

  3. No painel Connect to your instance (Conectar-se à instância), para Connection method (Método de conexão), selecione Session Manager (Gerenciador de sessões) e depois Connect (Conectar).

  4. Na janela de sessão do terminal, insira os comandos a seguir. Esses comandos criam a pasta tmp com as permissões corretas para que o soquete tmux esteja disponível.

    sudo mkdir /tmp sudo chmod 777 /tmp sudo rmdir /tmp/tmux-*

(Voltar ao início)

Amazon EC2

A seção a seguir descreve a solução de problemas relacionados ao instalador do Amazon EC2.

As instâncias do Amazon EC2 não são atualizadas automaticamente

Problema: as atualizações recentes do sistema não são aplicadas automaticamente a uma instância do Amazon EC2 que se conecta a um ambiente de desenvolvimento do AWS Cloud9.

Causa: aplicar automaticamente atualizações recentes do sistema pode fazer com que o código ou a instância do Amazon EC2 se comporte de forma inesperada, sem conhecimento ou aprovação prévios.

Soluções recomendadas:

Aplique as atualizações do sistema à instância do Amazon EC2 regularmente, seguindo as instruções em Updating Instance Software(Atualizar o software da instância) no Manual do usuário do Amazon EC2 para instâncias do Linux.

Para executar comandos na instância, use uma sessão de terminal no IDE do AWS Cloud9 no ambiente que estiver conectado à instância.

Como alternativa, use um utilitário de acesso remoto SSH como ssh ou o PuTTY para se conectar à instância. Para fazer isso, no seu computador local, use um utilitário de criação de par de chaves SSH como ssh-keygen ou PuTTYgen. Use o IDE do AWS Cloud9 no ambiente que estiver conectado à instância para armazenar a chave pública gerada na instância. Depois, use o utilitário de acesso remoto SSH com a chave privada gerada para acessar a instância. Para obter mais informações, consulte a documentação do utilitário.

Erro da AWS CLI ou do AWS-shell: “The security token included in the request is invalid” (O token de segurança incluso na solicitação é inválido), em um ambiente do EC2

Problema: ao tentar usar a AWS Command Line Interface (AWS CLI) ou o AWS-shell para executar um comando no IDE do AWS Cloud9 para um ambiente do EC2, um erro é exibido: “The security token included in the request is invalid” (O token de segurança incluso na solicitação é inválido).

Causa: um token de segurança inválido pode resultar se você tiver credenciais temporárias gerenciadas pela AWS habilitadas e um dos problemas a seguir ocorreu:

  • Você tentou executar um comando que não é permitido pelas credenciais temporárias gerenciadas pela AWS. Para obter uma lista de comandos permitidos, consulte Ações suportadas por credenciais temporárias AWS gerenciadas.

  • As credenciais temporárias gerenciadas pela AWS também expiram automaticamente a cada 15 minutos.

  • As credenciais temporárias gerenciadas pela AWS para um ambiente compartilhado foram desativadas porque um novo membro foi adicionado por alguém que não é o proprietário do ambiente.

Soluções recomendadas:

  • Execute apenas os comandos que forem permitidos pelas credenciais temporárias gerenciadas pela AWS. Se você precisar executar um comando não permitido pelas credenciais temporárias gerenciadas pela AWS, configure a AWS CLI ou o AWS-shell no ambiente com um conjunto de credenciais permanentes. Isso elimina essa limitação. Para obter instruções, consulte Crie e armazene as credenciais de acesso permanentes em um ambiente.

  • Para credenciais desativadas ou expiradas, o proprietário do ambiente deverá abrir o ambiente para que o AWS Cloud9 possa atualizar as credenciais temporárias no ambiente. Para obter mais informações, consulte Controlar o acesso às credenciais temporárias gerenciadas pela AWS.

Não é possível se conectar ao ambiente do EC2 porque os endereços IP da VPC são usados pelo Docker

Problema: para um ambiente do EC2, se você iniciar a instância do EC2 em uma Amazon VPC que use o bloco IPv4 172.17.0.0/16 do Encaminhamento Entre Domínios Sem Classificação (CIDR), a conexão poderá parar quando você tentar abrir esse ambiente.

Causa: o Docker usa um dispositivo de camada de link, chamado rede de ponte, que permite que os contêineres conectados à mesma rede de ponte se comuniquem. O AWS Cloud9 cria contêineres que usam uma ponte padrão para comunicação com o contêiner. A ponte padrão geralmente usa a sub-rede 172.17.0.0/16 para rede de contêineres.

Se a sub-rede da VPC para a instância do ambiente usar o mesmo intervalo de endereços que já for usado pelo Docker, poderá ocorrer um conflito de endereço IP. Então, quando o AWS Cloud9 tentar se conectar à sua instância, essa conexão será roteada pela tabela de rotas do gateway para a ponte do Docker. Isso impede que o AWS Cloud9 se conecte à instância do EC2 que apoia o ambiente de desenvolvimento.

Solução recomendada: para resolver um conflito de endereço IP causado pela Amazon VPC e o Docker usando o mesmo bloco de endereço IPv4 CIDR, configure uma nova VPC para a instância que faz backup do ambiente do EC2. Para esta nova VPC, configure um bloco CIDR diferente do 172.17.0.0/16. (Não é possível alterar o intervalo de endereços IP de uma VPC ou sub-rede existente.)

Para obter mais informações, consulte VPC and subnet sizing (Dimensionamento da VPC e da sub-rede) no Manual do usuário da Amazon VPC.

Não é possível criar a estrutura de subpastas /home/ec2-user/environment/home/ec2-user/environment no explorador de arquivos do IDE do AWS Cloud9.

Problema: ao criar a estrutura de subpastas /home/ec2-user/environment/home/ec2-user/environment no explorador de arquivos do IDE do AWS Cloud9, você recebe uma mensagem de erro informando que não é possível abrir esse diretório.

Causas possíveis: no momento, não é possível criar uma estrutura de subpastas /home/ec2-user/environment em uma pasta com o mesmo nome usando o sistema de arquivos do IDE do AWS Cloud9. Você não poderá acessar nenhum arquivo dentro desse diretório pelo explorador de arquivos do IDE do AWS Cloud9, mas poderá acessá-los usando a linha de comando. Esse problema afeta apenas o caminho de arquivo /home/ec2-user/environment/home/ec2-user/environment; caminhos de arquivo como /test/home/ec2-user/environment e /home/ec2-user/environment/test devem funcionar. Esse é um problema conhecido e afeta somente o File Explorer do IDE do AWS Cloud9.

Soluções recomendadas: use um nome e uma estrutura de arquivo diferentes.

Não é possível iniciar o AWS Cloud9 no console quando uma configuração de licença do AWS License Manager é associada a instâncias do Amazon EC2

Problema: quando você tenta iniciar um ambiente do AWS Cloud9 EC2 no console, uma mensagem de erro unable to access your environment é retornada.

Causas possíveis: o AWS License Manager otimiza o gerenciamento de licenças de fornecedores de software em todo a Nuvem AWS. Ao configurar o License Manager, você cria configurações de licença, que são conjuntos de regras de licenciamento baseadas nos termos dos contratos empresariais. Essas configurações de licença podem ser anexadas a um mecanismo, como uma Imagem de máquina da Amazon (AMI) ou AWS CloudFormation. Você pode usar um desses mecanismos para iniciar instâncias do EC2.

Versões antigas de AWSCloud9ServiceRolePolicy para a função vinculada a serviço (SLR) AWSServiceRoleForAWSCloud9 atualmente não incluem a condição de recurso license-configuration. Por esse motivo, o AWS Cloud9 não tem permissão para iniciar e interromper sua instância. Assim, o acesso do AWS Cloud9 à instância do Amazon EC2 é negado e um erro é exibido.

Soluções recomendadas: se não for possível acessar um ambiente existente do AWS Cloud9 e usar o License Manager, substitua o perfil antigo vinculado a serviço AWSCloud9ServiceRolePolicy pela versão do SLR que permite explicitamente ações do EC2 quando um license-configuration se aplica à instância. É possível substituir a função antiga simplesmente excluindo-a. Em seguida, a função atualizada será criada automaticamente.

Não é possível executar alguns comandos ou scripts em um ambiente do EC2

Problema: depois de abrir um ambiente de desenvolvimento EC2 do AWS Cloud9, não é possível instalar alguns tipos de pacote, executar comandos, como yum ou apt, nem executar scripts com comandos que geralmente funcionam com outros sistemas operacionais Linux.

Causa: as instâncias do Amazon EC2 que o AWS Cloud9 usa para um ambiente EC2 dependem do Amazon Linux (que é baseado no Red Hat Enterprise Linux, RHEL) ou do Ubuntu Server.

Solução: se você instalar ou gerenciar pacotes ou executar comandos ou scripts no IDE para um ambiente EC2, certifique-se de que eles sejam compatíveis com RHEL (para o Amazon Linux) ou Ubuntu Server, dependendo da instância desse ambiente.

Mensagem de erro relatando que o “Perfil de instância AWSCloud9SSMinstanceProfile não existe na conta” ao criar o ambiente EC2 usando o AWS CloudFormation

Problema: ao usar o recurso AWS CloudFormation do AWS::Cloud9::EnvironmentEC2 para criar um ambiente EC2, os usuários receberão uma mensagem de erro alertando que o Perfil da instância AWSCloud9SSMinstanceProfile não existe na conta.

Causa: ao criar um ambiente EC2 sem entrada, você deve criar a função de serviço AWSCloud9SSMAccessRole e o perfil da instância AWSCloud9SSMInstanceProfile. Esses recursos do IAM permitem que o Systems Manager gerencie a instância do EC2 que apoia seu ambiente de desenvolvimento.

Se você criar um ambiente sem entrada com o console, AWSCloud9SSMAccessRole e AWSCloud9SSMInstanceProfile serão criadas automaticamente. Porém, ao usar o AWS CloudFormation ou a AWS CLI para criar seu primeiro ambiente sem entrada, você deverá criar esses recursos do IAM manualmente.

Solução recomendada: para obter informações sobre como editar o modelo AWS CloudFormation e atualizar as permissões do IAM, consulte Usar o AWS CloudFormation para criar ambientes EC2 sem entrada

Mensagem de erro relatando que “não tem autorização para perform: ssm:StartSession no recurso” ao criar o ambiente do EC2 usando o AWS CloudFormation

Problema: ao usar o recurso AWS::Cloud9::EnvironmentEC2 do AWS CloudFormation para criar um ambiente do EC2, os usuários recebem um AccessDeniedException e são informados de que eles “não estão autorizados a executar ssm:StartSession no recurso”.

Causa: o usuário não tem permissão para chamar a API StartSession necessária como parte da configuração para ambientes EC2 que usam o Systems Manager para instâncias sem entrada.

Solução recomendada: para obter informações sobre como editar o modelo AWS CloudFormation e atualizar as permissões do IAM, consulte Usar o AWS CloudFormation para criar ambientes EC2 sem entrada.

Mensagem de erro informando que não há autorização para executar iam:GetInstanceProfile no recurso: perfil da instância AWSCloud9SSMInstanceProfile ao criar o ambiente EC2 usando o AWS CLI

Problema: ao usar o AWS CLI para criar um ambiente do EC2, os usuários recebem um AccessDeniedException e são informados de que o ambiente do AWS Cloud9 não está autorizado a “executar iam: getInstanceProfile no recurso: perfil da instância AWSCloud9SSMInstanceProfile”.

Causa: o AWS Cloud9 não tem permissão para chamar a API StartSession que é necessária como parte da configuração de ambientes do EC2 que usam o Systems Manager para instâncias sem ingresso.

Solução recomendada: para obter informações sobre como adicionar o perfil de serviço AWSCloud9SSMAccessRole e o AWSCloud9SSMInstanceProfile necessários ao seu ambiente do AWS Cloud9, consulte Gerenciar perfis da instância para o Systems Manager com a AWS CLI.

Falha ao criar o ambiente quando a criptografia padrão for aplicada aos volumes do Amazon EBS

Problema: erro Failed to create environments. The development environment '[environment-ID]' failed to create é retornado ao tentar criar um ambiente do Amazon EC2.

Possíveis causas: se o IDE do AWS Cloud9 usar volumes do Amazon EBS criptografados por padrão, a função vinculada ao serviço do AWS Identity and Access Management para o AWS Cloud9 solicitará acesso ao AWS KMS keys para esses volumes do EBS. Se o acesso não for fornecido, poderá ocorrer uma falha na inicialização do IDE do AWS Cloud9 e a depuração do problema poderá ser difícil.

Soluções recomendadas: para fornecer acesso, adicione a função vinculada ao serviço para o AWS Cloud9, AWSServiceRoleForAWSCloud9, para a chave gerenciada pelo cliente usada pelos volumes do Amazon EBS.

Para obter mais informações sobre essa tarefa, consulte Criar um AWS Cloud9 que usa volumes do Amazon EBS com criptografia padrão em Padrões de orientação prescritiva da AWS.

Erro de VPC para contas EC2-Classic: “Não é possível acessar seu ambiente”

Problema: o EC2-Classic foi introduzido na versão original do Amazon EC2. Se você usar uma Conta da AWS que foi configurada antes de 4 de dezembro de 2013, esse erro poderá ocorrer se você não configurar uma Amazon VPC e uma sub-rede ao criar um ambiente de desenvolvimento EC2 do AWS Cloud9.

Se você aceitar as configurações padrão da VPC, a instância do Amazon EC2 será iniciada na rede EC2-Classic. A instância não é executada em uma sub-rede da VPC padrão. A seguinte mensagem é exibida quando ocorre uma falha na criação do ambiente:

Erro de ambiente

Não é possível acessar o seu ambiente

The environment creation failed with the error: The following resource(s) failed to create: [Instance]. . Rollback requested by user..

Você pode confirmar que o erro é causado pelo fato de a instância do EC2 não estar na VPC padrão. Use o AWS CloudFormation para exibir o histórico de eventos da pilha para o ambiente de desenvolvimento.

  1. Abra o console do AWS CloudFormation. Para obter mais informações, consulte Fazer login no console do AWS CloudFormation.

  2. No console do AWS CloudFormation, selecione Pilhas.

  3. Na página Pilhas, escolha o nome do ambiente de desenvolvimento que não conseguiu criar.

  4. Na página Stack details (Detalhes da pilha), selecione a guia Events (Eventos) e procure a seguinte entrada:

    Status: CREATE_FAILED

    Motivo do status: o parâmetro AssociatePublicIpAddress tem suporte apenas em execuções da VPC. [...]

Causa: um ambiente de desenvolvimento do AWS Cloud9 deve ser associado a uma Amazon VPC que atenda aos requisitos específicos da VPC. Para contas com o EC2-Classic habilitado, aceitar as configurações de rede padrão ao criar um ambiente EC2 significa que a instância do EC2 necessária não é executada na VPC. Em vez disso, a instância é executada na rede EC2-Classic.

Solução recomendada: com uma conta EC2-Classic, você deve selecionar uma VPC e uma sub-rede quando criar um ambiente EC2. Na página Definir configurações, na seção Configurações de rede (avançadas), selecione a VPC e a sub-rede em que você pode executar sua instância do EC2.

Outros produtos da AWS

A seção a seguir descreve a solução de problemas relacionados a outros serviços do AWS.

Não é possível criar a estrutura de subpastas /projects/projects no explorador de arquivos do IDE do AWS Cloud9 para CodeCatalyst.

Problema: quando você cria a estrutura de subpastas /projects/projects no explorador de arquivos do IDE do AWS Cloud9 para CodeCatalyst, você recebe uma mensagem de erro informando que não é possível abrir esse diretório.

Causas possíveis: no momento, não é possível criar uma estrutura de subpastas /projects em uma pasta com o mesmo nome usando o explorador de arquivos do IDE do AWS Cloud9 para CodeCatalyst. Você não poderá acessar nenhum arquivo dentro desse diretório pelo explorador de arquivos do IDE do AWS Cloud9, mas poderá acessá-los usando a linha de comando. Esse problema afeta apenas o caminho do arquivo /projects/projects; caminhos de arquivo como /test/projects e /projects/test/ devem funcionar. Esse é um problema conhecido e afeta somente o explorador de arquivos do IDE do AWS Cloud9 para CodeCatalyst.

Soluções recomendadas: use um nome e uma estrutura de arquivo diferentes.

Não é possível exibir a aplicação em execução fora do IDE

Problema: quando você ou outras pessoas tentarem exibir a aplicação em execução em uma guia de navegador da Web fora do IDE, essa guia de navegador da Web exibirá um erro ou estará em branco.

Causas possíveis:

  • A aplicação não está em execução no IDE.

  • O aplicativo está em execução com um IP 127.0.0.1 ou localhost.

  • A aplicação está em execução em um ambiente de desenvolvimento EC2 do AWS Cloud9. Além disso, um ou mais grupos de segurança associados à instância do Amazon EC2 correspondente não permitem tráfego de entrada nos protocolos, nas portas nem nos endereços IP exigidos pela aplicação.

  • A aplicação está em execução em um ambiente de desenvolvimento SSH do AWS Cloud9 para uma instância de computação em nuvem da AWS (por exemplo, uma instância do Amazon EC2). Além disso, a ACL de rede da sub-rede na nuvem privada virtual (VPC) associada à instância correspondente não permite tráfego de entrada nos protocolos, nas portas nem nos endereços IP exigidos pela aplicação.

  • O URL está incorreto.

  • O URL na guia de visualização do aplicativo está sendo solicitado em vez do endereço IP público da instância.

  • Você está tentando acessar um endereço que contém um IP 127.0.0.1 ou localhost. Esses IPs tentam acessar recursos no computador local, em vez de recursos no ambiente.

  • O endereço IP público da instância foi alterado.

  • A solicitação da web se origina em uma rede privada virtual (VPN) que bloqueia o tráfego nos protocolos, portas ou endereços IP que o aplicativo requer.

  • A aplicação está em execução em um ambiente SSH. No entanto, seu servidor ou a rede associada não permite tráfego nos protocolos, nas portas nem nos endereços IP exigidos pela aplicação.

Soluções recomendadas:

  • Verifique se a aplicação está em execução no IDE.

  • Garanta que a aplicação não esteja em execução com um IP 127.0.0.1 ou localhost. Para obter exemplos em Node.js e Python, consulte Execute uma aplicação.

  • Suponha que a aplicação esteja em execução em uma instância de computação em nuvem da AWS (por exemplo, uma instância do Amazon EC2). Depois, verifique se todos os grupos de segurança associados à instância correspondente permitem tráfego de entrada nos protocolos, nas portas e nos endereços IP exigidos pela aplicação. Para obter instruções, consulte Etapa 2: Configurar o grupo de segurança para a instância em Compartilhar uma aplicação em execução pela Internet. Para saber mais, consulte Grupos de segurança para a VPC no Manual do usuário da Amazon VPC.

  • Suponha que a aplicação esteja em execução em uma instância de computação em nuvem da AWS. Além disso, existe uma ACL de rede para a sub-rede na VPC associada à instância correspondente. Depois, garanta que a ACL de rede permita o tráfego de entrada nos protocolos, nas portas e nos endereços IP exigidos pela aplicação. Para obter instruções, consulte Etapa 3: Configurar a sub-rede para a instância em Compartilhar uma aplicação em execução pela Internet. Consulte também ACLs da rede no Manual do usuário da Amazon VPC.

  • Verifique se o URL solicitado, incluindo o protocolo (e porta, se deve ser especificada), está correto. Para obter mais informações, consulte Etapa 4: Compartilhar o URL de sua aplicação em execução em Share a running application over the internet (Compartilhar uma aplicação em execução pela Internet).

  • Não recomendamos solicitar um URL com o formato https://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/ (em que 12a34567b8cd9012345ef67abcd890e1 é o ID que o AWS Cloud9 atribui ao ambiente e us-east-2 é o ID da região da AWS para o ambiente). Esse URL funciona somente quando o IDE do ambiente estiver aberto e a aplicação estiver em execução no mesmo navegador da Web.

  • Suponha que você esteja tentando acessar um endereço que contenha um IP 127.0.0.1 ou localhost. Em vez disso, tente acessar o endereço não local correto da aplicação em execução. Para obter mais informações, consulte Compartilhar uma aplicação em execução pela Internet.

  • Suponha que a aplicação esteja em execução em uma instância de computação em nuvem da AWS. Determine se o endereço IP público da instância foi alterado. O endereço IP público da instância pode mudar sempre que a instância reiniciar. Para evitar que esse endereço IP mude, aloque um endereço IP elástico e o atribua à instância em execução. Para obter mais informações, consulte Etapa 4: Compartilhar o URL de sua aplicação em execução em Share a running application over the internet (Compartilhar uma aplicação em execução pela Internet).

  • Se a solicitação da web se origina em uma VPN, verifique se essa VPN permite o tráfego nos protocolos, portas e endereços IP que o aplicativo requer. Se não conseguir fazer alterações na VPN, consulte o administrador de sua rede. Ou faça a solicitação da web por meio de uma rede diferente, se possível.

  • Suponha que a aplicação esteja em execução em um ambiente SSH para seu próprio servidor. Garanta que seu servidor e a rede associada permitam tráfego nos protocolos, nas portas e nos endereços IP exigidos pela aplicação. Se não for possível fazer alterações no servidor ou na rede associada, consulte o administrador do servidor ou da rede.

  • Tente executar a aplicação em um terminal no ambiente, executando o comando curl, seguido pelo URL. Se esse comando exibir uma mensagem de erro, é provável que haja algum outro problema não relacionado ao AWS Cloud9.

Erro ao executar o AWS Toolkit: “Seu ambiente está ficando sem inodes, aumente o limite 'fs.inotify.max_user_watches'.”

Problema: um utilitário de observação de arquivos usado pelo kit de ferramentas da AWS está se aproximando do limite ou da atual de arquivos que ele pode observar.

Causa: O AWS Toolkit usa um utilitário de observação de arquivos que monitora alterações em arquivos e diretórios. Quando o utilitário estiver quase atingindo a cota atual de arquivos que ele pode observar, uma mensagem de aviso será exibida.

Solução recomendada: para aumentar o número máximo de arquivos que podem ser manipulados pelo observador de arquivos, faça o seguinte:

  1. Para iniciar uma sessão do terminal, selecione Window (Janela), New Terminal (Novo terminal) na barra de menus.

  2. InInsira o comando .

    sudo bash -c 'echo "fs.inotify.max_user_watches=524288" >> /etc/sysctl.conf' && sudo sysctl -p

Erro de execução da função do Lambda local: não é possível instalar o SAM Local

Problema: depois de tentar executar a versão local de uma função do AWS Lambda no IDE do AWS Cloud9, uma caixa de diálogo é exibida. A caixa de diálogo afirma que o AWS Cloud9 está tendo problemas para instalar o SAM Local. O AWS Cloud9 precisa do SAM Local para executar versões locais de funções do AWS Lambda no IDE. Enquanto o SAM Local não for instalado, não será possível executar versões locais de funções do Lambda no IDE.

Causa: o AWS Cloud9 não encontra o SAM Local no caminho esperado no ambiente, que é o ~/.c9/bin/sam. O motivo é que o SAM Local ainda não está instalado ou, se estiver instalado, o AWS Cloud9 não consegue encontrá-lo nesse local.

Soluções recomendadas: aguarde até que o AWS Cloud9 conclua a instalação do SAM Local ou instale-o por conta própria.

Para consultar o andamento da tentativa do AWS Cloud9 de instalar o SAM Local, selecione Window, Installer (Janela, Instalador) na barra de menus.

Para instalar o SAM Local por conta própria, siga as instruções fornecidas em Instalar a CLI do SAM AWS no Linux (Instalar a CLI do SAM no Linux) no Guia do desenvolvedor do AWS Serverless Application Model.

Erro AWS Control Tower ao tentar criar um ambiente Amazon EC2 usando AWS Cloud9: “A criação do ambiente falhou com o erro: Os seguintes ganchos falharam: [ControlTower: :Guard: :Hook].”

Problema: existe um problema de compatibilidade com AWS Cloud9 o controle proativo AWS Control Tower CT.EC2.PR.8. Se esse controle estiver ativo, você não poderá criar um ambiente EC2 no AWS Cloud9.

Causa: espera AWS Control Tower que o parâmetro AssociatePublicipAddress esteja no modelo AWS CloudFormation. Esse parâmetro não pode ser adicionado no momento.

Solução recomendada: Desative o controleCT.EC2.PR.8 do console AWS Control Tower e recrie o ambiente em AWS Cloud9.

Falha ao criar o ambiente quando a criptografia padrão for aplicada aos volumes do Amazon EBS

Problema: erro Failed to create environments. The development environment '[environment-ID]' failed to create é retornado ao tentar criar um ambiente do Amazon EC2.

Possíveis causas: se o IDE do AWS Cloud9 usar volumes do Amazon EBS criptografados por padrão, a função vinculada ao serviço do AWS Identity and Access Management para o AWS Cloud9 solicitará acesso ao AWS KMS keys para esses volumes do EBS. Se o acesso não for fornecido, poderá ocorrer uma falha na inicialização do IDE do AWS Cloud9 e a depuração do problema poderá ser difícil.

Soluções recomendadas: para fornecer acesso, adicione a função vinculada ao serviço para o AWS Cloud9, AWSServiceRoleForAWSCloud9, para a chave gerenciada pelo cliente usada pelos volumes do Amazon EBS.

Para obter mais informações sobre essa tarefa, consulte Criar um AWS Cloud9 que usa volumes do Amazon EBS com criptografia padrão em Padrões de orientação prescritiva da AWS.

(Voltar ao início)

Não é possível iniciar o AWS Cloud9 no console quando uma configuração de licença do AWS License Manager é associada a instâncias do Amazon EC2

Problema: quando você tenta iniciar um ambiente do AWS Cloud9 EC2 no console, uma mensagem de erro unable to access your environment é retornada.

Causas possíveis: o AWS License Manager otimiza o gerenciamento de licenças de fornecedores de software em todo a Nuvem AWS. Ao configurar o License Manager, você cria configurações de licença, que são conjuntos de regras de licenciamento baseadas nos termos dos contratos empresariais. Essas configurações de licença podem ser anexadas a um mecanismo, como uma Imagem de máquina da Amazon (AMI) ou AWS CloudFormation. Você pode usar um desses mecanismos para iniciar instâncias do EC2.

Versões antigas de AWSCloud9ServiceRolePolicy para a função vinculada a serviço (SLR) AWSServiceRoleForAWSCloud9 atualmente não incluem a condição de recurso license-configuration. Por esse motivo, o AWS Cloud9 não tem permissão para iniciar e interromper sua instância. Assim, o acesso do AWS Cloud9 à instância do Amazon EC2 é negado e um erro é exibido.

Soluções recomendadas: se não for possível acessar um ambiente existente do AWS Cloud9 e usar o License Manager, substitua o perfil antigo vinculado a serviço AWSCloud9ServiceRolePolicy pela versão do SLR que permite explicitamente ações do EC2 quando um license-configuration se aplica à instância. É possível substituir a função antiga simplesmente excluindo-a. Em seguida, a função atualizada será criada automaticamente.

(Voltar ao início)

Pré-visualização do aplicativo

A seção a seguir descreve a solução de problemas relacionados à visualização prévia do aplicativo.

Após recarregar um ambiente, é necessário atualizar a previsualização da aplicação

Problema: após recarregar um ambiente que exibe uma guia de visualização da aplicação, a guia não exibirá a visualização da aplicação.

Causa: às vezes, os usuários escrevem um código que pode executar um loop infinito. Ou o código deles pode usar tanta memória que o IDE do AWS Cloud9 pode ser pausado ou interrompido quando a visualização da aplicação está sendo executada. Para evitar que isso aconteça, o AWS Cloud9 não recarrega as guias de visualização da aplicação sempre que um ambiente for recarregado.

Solução: após recarregar um ambiente que exibe uma guia de previsualização da aplicação, para exibir a previsualização da aplicação, selecione o botão Click to load the page (Clique para carregar a página) na guia.

Aviso de visualização de aplicação ou arquivo: "Cookies de terceiros desativados"

Problema: quando você tenta visualizar um aplicativo ou um arquivo, é exibido um aviso com a seguinte mensagem: "A funcionalidade de visualização está desativada porque os cookies de terceiros estão desativados no navegador".

Causa: cookies de terceiros não são necessários para abrir o IDE do AWS Cloud9. No entanto, você deverá habilitar cookies de terceiros para usar os recursos Application Preview (Visualização de aplicações) ou File Preview (Visualização de arquivos).

Solução: ative os cookies de terceiros no navegador da web, recarregue o IDE e tente abrir a visualização novamente.

Se o seu navegador da web permitir essa granularidade, você poderá habilitar cookies de terceiros somente para AWS Cloud9. Para isso, especifique os domínios a seguir, dependendo das Regiões da AWS onde você queira usar o AWS Cloud9.

Região da AWS Domínios

Leste dos EUA (Norte da Virgínia)

*.vfs.cloud9.us-east-1.amazonaws.com

vfs.cloud9.us-east-1.amazonaws.com

Leste dos EUA (Ohio)

*.vfs.cloud9.us-east-2.amazonaws.com

vfs.cloud9.us-east-2.amazonaws.com

Oeste dos EUA (N. da Califórnia)

*.vfs.cloud9.us-west-1.amazonaws.com

vfs.cloud9.us-west-1.amazonaws.com

Oeste dos EUA (Oregon)

*.vfs.cloud9.us-west-2.amazonaws.com

vfs.cloud9.us-west-2.amazonaws.com

África (Cidade do Cabo)

*.vfs.cloud9.af-south-1.amazonaws.com

vfs.cloud9.af-south-1.amazonaws.com

Ásia-Pacífico (Hong Kong)

*.vfs.cloud9.ap-east-1.amazonaws.com

vfs.cloud9.ap-east-1.amazonaws.com

Ásia-Pacífico (Mumbai)

*.vfs.cloud9.ap-south-1.amazonaws.com

vfs.cloud9.ap-south-1.amazonaws.com

Ásia-Pacífico (Osaka)

*.vfs.cloud9.ap-northeast-3.amazonaws.com

vfs.cloud9.ap-northeast-3.amazonaws.com

Ásia-Pacífico (Seul)

*.vfs.cloud9.ap-northeast-2.amazonaws.com

vfs.cloud9.ap-northeast-2.amazonaws.com

Ásia-Pacífico (Singapura)

*.vfs.cloud9.ap-southeast-1.amazonaws.com

vfs.cloud9.ap-southeast-1.amazonaws.com

Ásia-Pacífico (Sydney)

*.vfs.cloud9.ap-southeast-2.amazonaws.com

vfs.cloud9.ap-southeast-2.amazonaws.com

Ásia-Pacífico (Tóquio)

*.vfs.cloud9.ap-northeast-1.amazonaws.com

vfs.cloud9.ap-northeast-1.amazonaws.com

Canadá (Central)

*.vfs.cloud9.ca-central-1.amazonaws.com

vfs.cloud9.ca-central-1.amazonaws.com

Europa (Frankfurt)

*.vfs.cloud9.eu-central-1.amazonaws.com

vfs.cloud9.eu-central-1.amazonaws.com

Europa (Irlanda)

*.vfs.cloud9.eu-west-1.amazonaws.com

vfs.cloud9.eu-west-1.amazonaws.com

Europa (Londres)

*.vfs.cloud9.eu-west-2.amazonaws.com

vfs.cloud9.eu-west-2.amazonaws.com

Europa (Milão)

*.vfs.cloud9.eu-south-1.amazonaws.com

vfs.cloud9.eu-south-1.amazonaws.com

Europa (Paris)

*.vfs.cloud9.eu-west-3.amazonaws.com

vfs.cloud9.eu-west-3.amazonaws.com

Europa (Estocolmo)

*.vfs.cloud9.eu-north-1.amazonaws.com

vfs.cloud9.eu-north-1.amazonaws.com

Oriente Médio (Bahrein)

*.vfs.cloud9.me-south-1.amazonaws.com

vfs.cloud9.me-south-1.amazonaws.com

América do Sul (São Paulo)

*.vfs.cloud9.sa-east-1.amazonaws.com

vfs.cloud9.sa-east-1.amazonaws.com

A guia de visualização da aplicação exibe um erro ou está em branco

Problema: na barra de menus no IDE, ao selecionar Preview, Preview Running Application (Visualizar, Visualizar a aplicação em execução) ou Tools, Preview, Preview Running Application (Ferramentas, Visualizar, Visualizar a aplicação em execução) para tentar exibir a aplicação em um guia de visualização no IDE a guia exibirá um erro ou estará em branco.

Causas possíveis:

  • Sua aplicação não está em execução no IDE.

  • Sua aplicação não está em execução usando o HTTP.

  • O aplicativo está em execução em mais de uma porta.

  • O aplicativo está em execução em uma porta diferente de 8080, 8081 ou 8082.

  • O aplicativo está em execução com um IP diferente de 127.0.0.1, localhost ou 0.0.0.0.

  • A porta (8080, 8081 ou 8082) não está especificada no URL na guia de visualização.

  • Sua rede bloqueia o tráfego de entrada para as portas 8080, 8081 ou 8082.

  • Você está tentando acessar um endereço que contém um IP 127.0.0.1, localhost ou 0.0.0.0. Por padrão, o IDE do AWS Cloud9 tenta acessar o computador local. Ele não tenta acessar a instância nem seu próprio servidor conectado ao ambiente.

Soluções recomendadas:

  • Verifique se a aplicação está em execução no IDE.

  • Verifique se o aplicativo está em execução usando o HTTP. Para obter exemplos em Node.js e Python, consulte Execute uma aplicação.

  • Verifique se o aplicativo está em execução somente em uma porta. Para obter exemplos em Node.js e Python, consulte Execute uma aplicação.

  • Verifique se o aplicativo está em execução na porta 8080, 8081 ou 8082. Para obter exemplos em Node.js e Python, consulte Execute uma aplicação.

  • Verifique se o aplicativo está em execução com um IP 127.0.0.1, localhost ou 0.0.0.0. Para obter exemplos em Node.js e Python, consulte Execute uma aplicação.

  • Adicione :8080, :8081 ou :8082 ao URL na guia de visualização.

  • Verifique se a rede permite o tráfego de entrada pelas portas 8080, 8081 ou 8082. Se não conseguir fazer alterações na rede, consulte o administrador da sua rede.

  • Se você estiver tentando acessar um endereço que contenha um IP 127.0.0.1, localhost ou 0.0.0.0, tente acessar o seguinte endereço: https://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/. Nesse endereço, 12a34567b8cd9012345ef67abcd890e1 é o ID que o AWS Cloud9 atribui ao ambiente. us-east-2 é o ID da Região da AWS para o ambiente. Você também pode tentar acessar esse endereço fora do IDE. No entanto, isso funciona somente quando o IDE do ambiente está aberto e a aplicação está em execução no mesmo navegador da web.

  • Assim que você garantir que todas as condições anteriores sejam atendidas, tente interromper a aplicação e iniciá-la novamente.

  • Se você interrompeu o aplicativo e o iniciou novamente, tente selecionar Preview, Preview Running Application (Visualizar, Visualizar o aplicativo em execução) ou Tools, Preview, Preview Running Application (Ferramentas, Visualizar, Visualizar o aplicativo em execução) na barra de menus novamente. Ou tente selecionar o botão Refresh (Atualizar) (seta circular) na guia de visualização do aplicativo correspondente, se a guia já estiver visível.

Não é possível visualizar o conteúdo da web no IDE porque a conexão com o site não é segura

Problema: quando você tenta acessar conteúdo da web, por exemplo, um site do WordPress hospedado em um ambiente do EC2 do AWS Cloud9, a janela de visualização do IDE não consegue exibi-lo.

Possíveis causas: por padrão, todas as páginas da Web que você acessa na guia de visualização da aplicação do IDE do AWS Cloud9 usa automaticamente o protocolo HTTPS. Se o URI de uma página apresentar o protocolo http inseguro, ele será automaticamente substituído por https. Além disso, você não pode acessar o conteúdo inseguro revertendo manualmente o https para http.

Soluções recomendadas: remova os scripts HTTP ou o conteúdo inseguro do site que você estiver tentando visualizar no IDE. Siga as instruções do seu servidor Web ou sistema de gerenciamento de conteúdo para obter orientação sobre a implementação de HTTPS.

A visualização de um arquivo retorna um erro 499

Problema: ao tentar usar o AWS Cloud9 para visualizar um arquivo que contenha um elemento <script> com os atributos src e type definidos como module, é exibido um erro 499 e o script não é executado como esperado.

Causa: as solicitações para obter a visualização de arquivos no IDE do AWS Cloud9 exigem que os cookies sejam enviados pelo navegador da Web para fazer a autenticação. Por padrão, os navegadores da web enviam cookies para solicitações regulares de scripts. Eles não enviam cookies para solicitações de script de módulo, a menos que você adicione o atributo crossorigin.

Solução: adicione o atributo crossorigin ao elemento <script>. Por exemplo, <script type="module" src="index.js" crossorigin></script>. Depois, salve o arquivo alterado e tente visualizá-lo novamente.

Performance

A seção a seguir descreve a solução de problemas relacionados ao desempenho.

Congelamento do IDE AWS Cloud9 por um período significativo de tempo

Problema: Durante a inicialização e ao realizar uma atualização, o terminal IDE AWS Cloud9 congela por um período significativo de tempo e se torna inutilizável.

Causa: Você pode ter uma grande quantidade de arquivos em seu ambiente que estão sendo monitorados recursivamente pelo módulo de monitoramento de arquivos do AWS Cloud9.

Soluções recomendadas: Você pode diminuir a profundidade de visualização do arquivo (o valor mínimo é 1) e considerar a adição de pastas grandes ou pastas não relacionadas ao código-fonte (saídas/artefatos de construção, pacotes de terceiros) aos padrões ignorados. Para fazer isso, navegue até Preferências > Configurações do usuário > Monitoramento de arquivos. Esteja ciente de que isso fará com que o CodeLenses no kit de ferramenta da AWS não funcione corretamente.

Outra solução possível é considerar ignorar arquivos e pastas grandes que não estejam relacionados ao código-fonte diminuindo o Número máximo de arquivos a serem pesquisados. Para fazer isso, navegue até Preferências > Configurações do projeto > Localizar em arquivos. Esteja ciente de que isso fará com que as pastas ignoradas não apareçam em uma pesquisa de arquivos.

Aviso do console: "Alternando para o mecanismo de conclusão de código mínimo..."

Problema: ao trabalhar no console do AWS Cloud9 (por exemplo, ao abrir o IDE ou atualizar a página da web do IDE), você verá esta mensagem: "One or more sessions or collaborators are active on this environment. Switching to the minimal code completion engine to conserve memory." (Uma ou mais sessões ou colaboradores estão ativos neste ambiente. Alternando para o mecanismo de conclusão de código mínimo para economizar memória.) Em correlação com essa mensagem, o comportamento de conclusão de código pode ser lento ou intermitente.

Causa: a execução do mecanismo de conclusão de código utiliza ciclos de memória e CPU do ambiente. Além disso, um mecanismo separado de conclusão de código é necessário para cada colaborador e cada sessão adicional. Para evitar o uso de muitos recursos, especialmente em instâncias pequenas, como t2.nano e t2.micro, o AWS Cloud9 alterna para o mecanismo mínimo de conclusão de código.

Solução recomendada: se você pretende colaborar com frequência e por longos períodos, selecione uma instância maior do Amazon EC2 ao criar seu ambiente do EC2. Ou conecte seu ambiente SSH a uma instância com maior capacidade.

nota

A seleção de uma instância maior do Amazon EC2 pode gerar cobranças adicionais em sua Conta da AWS. Para obter mais informações, consulte Preços do Amazon EC2.

Aviso do IDE: “Este ambiente está ficando sem memória” ou “Este ambiente tem alta carga de CPU”

Problema: enquanto o IDE estiver em execução, uma mensagem será exibida com a seguinte frase “este ambiente está ficando sem memória” ou “este ambiente tem alta carga de CPU”.

Causa: o IDE pode não ter recursos de computação disponíveis o suficiente para continuar sendo executado sem atrasar ou travar.

Soluções recomendadas:

  • Interrompa um ou mais processos em execução para liberar memória disponível. Para fazer isso, na barra de menu do IDE para o ambiente, selecione Tools, Process List (Ferramentas, Lista de processos). Para cada processo que deseja interromper, selecione o processo e, então, selecione Force Kill (Encerrar à força).

  • Crie um arquivo de troca no ambiente. Um arquivo de troca é um arquivo no ambiente que o sistema operacional pode usar como memória virtual.

    Para confirmar se o ambiente está usando memória de troca no momento, execute o comando top em uma sessão do terminal no ambiente. Se a memória de permuta estiver sendo usada, a saída exibe estatísticas de memória Swap diferente de zero (por exemplo, Swap: 499996k total, 1280k used, 498716 free, 110672k cached) Para interromper a exibição de informações de memória em tempo real, pressione Ctrl + C.

    Para criar um arquivo de troca, execute um comando no ambiente como a seguir.

    sudo fallocate --length 512MB /var/swapfile && sudo chmod 600 /var/swapfile && sudo mkswap /var/swapfile && echo '/var/swapfile swap swap defaults 0 0' | sudo tee -a /etc/fstab > /dev/null

    O comando anterior faz o seguinte:

    1. Cria um arquivo de 512 MB chamado swapfile no diretório /var.

    2. Altera as permissões de acesso ao arquivo swapfile para leitura e gravação somente para o proprietário.

    3. Configura o arquivo swapfile como um arquivo de troca.

    4. Grava informações no /etc/fstab file. Isso torna esse arquivo de troca disponível sempre que o sistema é reinicializado.

    Depois de executar o comando anterior, para tornar esse arquivo de troca disponível imediatamente, execute o comando a seguir.

    sudo swapon /var/swapfile
  • Mova ou redimensione o ambiente para uma instância ou um servidor com mais recursos de computação. Para mover ou redimensionar instâncias do Amazon EC2, consulte Mover um ambiente e redimensionar ou criptografar volumes do Amazon EBS. Para outros tipos de servidor ou instâncias, consulte a documentação da instância ou do servidor.

Não é possível fazer upload de arquivos no IDE AWS Cloud9

Problema: os usuários não conseguem carregar um arquivo grande no IDE AWS Cloud9. Esses uploads estão falhando.

Causa: AWS Cloud9 reduz a velocidade de upload para o IDE AWS Cloud9 e, como resultado, a solicitação de upload do arquivo expira.

Solução recomendada: Recomendamos fazer o upload do arquivo para o Amazon S3 e, em seguida, usar o Amazon S3 para baixar o arquivo para o ambiente com a CLI no IDE do AWS Cloud9. Para obter informações sobre upload de objetos para o Amazon S3, consulte Carregamento de objetos no Guia do usuário do Amazon S3.

Velocidade de download lenta no IDE do AWS Cloud9

Problema: os usuários estão lidando com velocidades de download lentas ao tentar baixar arquivos do IDE do AWS Cloud9.

Causa: Quando você baixa arquivos do IDE para o sistema de arquivos local, a velocidade de transferência será limitada a uma velocidade de 0,1 megabyte/segundo.

Solução recomendada: Para aumentar a velocidade de transferência de arquivos, use a CLI em seu IDE do AWS Cloud9 para fazer upload de arquivos para o Amazon S3 e, em seguida, use o Amazon S3 para baixar os arquivos de lá.

Não é possível visualizar o conteúdo da web no IDE porque a conexão com o site não é segura

Problema: quando você tenta acessar conteúdo da web, por exemplo, um site do WordPress hospedado em um ambiente do EC2 do AWS Cloud9, a janela de visualização do IDE não consegue exibi-lo.

Possíveis causas: por padrão, todas as páginas da Web que você acessa na guia de visualização da aplicação do IDE do AWS Cloud9 usa automaticamente o protocolo HTTPS. Se o URI de uma página apresentar o protocolo http inseguro, ele será automaticamente substituído por https. Além disso, você não pode acessar o conteúdo inseguro revertendo manualmente o https para http.

Soluções recomendadas: remova os scripts HTTP ou o conteúdo inseguro do site que você estiver tentando visualizar no IDE. Siga as instruções do seu servidor Web ou sistema de gerenciamento de conteúdo para obter orientação sobre a implementação de HTTPS.

(Voltar ao início)

Aplicativos e serviços de terceiros

A seção a seguir descreve a solução de problemas relacionados a outros serviços de terceiros e aplicações.

Não é possível interagir com a janela do terminal no AWS Cloud9 devido a erros de sessão de tmux

Problema: quando você tenta iniciar uma nova janela de terminal no AWS Cloud9, a interface de linha de comando esperada não está disponível. Não há prompt de comando e você não consegue inserir texto. Mensagens de erro, como tmux: need UTF-8 locale (LC_CTYPE) e invalid LC_ALL, LC_CTYPE or LANG, são retornadas.

Causas possíveis: a falta de resposta de um terminal pode ser causada por um erro de tmux. O AWS Cloud9 usa o utilitário tmux. Dessa forma, as informações exibidas no terminal persistem mesmo quando a página é recarregada ou quando você se reconecta ao ambiente de desenvolvimento.

Em uma sessão tmux, o que é exibido na janela do terminal é tratado por um cliente. O cliente se comunica com um servidor que pode gerenciar várias sessões. O servidor e o cliente se comunicam por meio de um soquete localizado na pasta tmp. Se a pasta tmp estiver faltando no ambiente de desenvolvimento ou permissões excessivamente restritivas forem aplicadas a ela, as sessões de tmux não poderão ser executadas. Se isso ocorrer, a janela do terminal no IDE deixa de responder.

Soluções recomendadas: se os erros de tmux estiverem impedindo a interação com a janela do terminal, use um modo alternativo para criar uma pasta tmp com as permissões adequadas. Dessa forma, as sessões tmux podem ser executadas. Uma solução é exportar LC_CTYPE em .bash_profile ou no arquivo .bashrc. Uma outra solução é usar o AWS Systems Manager para definir uma configuração de gerenciamento do host. Isso permite acesso à instância relevante por meio do console do Amazon EC2.

Configurar o gerenciamento de host

  1. Primeiro, no console do AWS Cloud9, encontre o nome da instância de seu ambiente. É possível fazer isso selecionando o painel relevante na página Your environments (Seus ambientes) e View details (Visualizar detalhes). Na página Detalhes do ambiente, escolha Ir para a instância. No console do Amazon EC2, confirme o nome da instância que você precisa acessar.

  2. Agora vá para o console do AWS Systems Manager e, no painel de navegação, escolha Configuração rápida.

  3. Na página Quick Setup (Configuração rápida), escolha Create (Criar).

  4. Para Configuration types (Tipos de configuração), vá para Host Management (Gerenciamento de host) e escolha Create (Criar).

  5. Para Customize Host Management configuration options (Personalizar opções de configuração de Gerenciamento de Host), na seção Targets (Destinos), escolha Manual.

  6. Selecione a instância do EC2 que você deseja acessar e depois escolha Create (Criar).

Conectar-se à instância e executar comandos

nota

As etapas a seguir se destinam ao novo console do EC2.

  1. No console do Amazon EC2, no painel de navegação, escolha Instâncias e selecione a instância à qual deseja se conectar.

  2. Selecione Conectar.

    Se Connect (Conectar) não estiver ativado, poderá ser necessário iniciar a instância primeiro.

  3. No painel Connect to your instance (Conectar-se à instância), para Connection method (Método de conexão), selecione Session Manager (Gerenciador de sessões) e depois Connect (Conectar).

  4. Na janela de sessão do terminal, insira os comandos a seguir. Esses comandos criam a pasta tmp com as permissões corretas para que o soquete tmux esteja disponível.

    sudo mkdir /tmp sudo chmod 777 /tmp sudo rmdir /tmp/tmux-*

Não é possível carregar o IDE usando versões mais antigas do navegador Microsoft Edge

Problema: erro HTTP403: FORBIDDEN é retornado ao tentar carregar o IDE do AWS Cloud9 usando o navegador da web Microsoft Edge.

Causas possíveis: o IDE do AWS Cloud9 não oferece suporte a certas versões mais antigas do Microsoft Edge.

Soluções recomendadas: para atualizar o navegador, escolha o botão de reticências (...) na barra de ferramentas do Microsoft Edge. No menu, selecione Configurações e Sobre o Microsoft Edge. Se uma atualização for necessária, ela será baixada e instalada automaticamente.

Erro com o gdb ao depurar projetos em C++

Problema: erro relatado para o depurador do gdb ao tentar depurar projeto C++ no IDE.

Possíveis causas: suponha que seu ambiente do AWS Cloud9 use certos tipos de instância do EC2 (por exemplo, t3.small ou m5.large). Depois, um erro de depuração poderá ocorrer quando você tentar executar e depurar um projeto em C++ usando o executor interno do IDE. Esse erro pode acontecer porque a versão do gdb (o Depurador de Projeto GNU), que é pré-instalada para o seu ambiente, não funciona em determinadas plataformas de processador. Você poderá ver o código de erro a seguir.

GDB server terminated with code 1

Soluções recomendadas: o problema do gdb não ser compatível com determinadas plataformas de processadores foi corrigido a partir da versão 3.0. Desinstale a versão mais antiga do depurador e atualize para uma versão mais recente do gdb:

  1. Remova a versão existente do depurador executando o comando a seguir no terminal do AWS Cloud9.

    sudo yum -y remove gdb
  2. Recupere o arquivo para gdb, descompacte-o e navegue até o diretório que contém os arquivos extraídos, executando os comandos a seguir.

    wget "http://ftp.gnu.org/gnu/gdb/gdb-8.3.tar.gz" tar xzf gdb-8.3.tar.gz cd gdb-8.3
  3. Crie o depurador executando o comando a seguir. Para fazer isso, copie e cole o texto a seguir como um único bloco e pressione Return para executar make.

    ./configure --prefix=/usr \ --with-system-readline \ --with-python=/usr/bin/python3 && make
  4. Instale o depurador.

    sudo make -C gdb install
  5. Confirme se a versão atualizada do depurador está instalada:

    gdb --version

Problemas com o executor de PHP em AWS Cloud9

Problema: Os usuários não conseguem visualizar nenhuma saída no terminal executor do PHP CLI.

Causa: O executor de CLI precisa ser configurado para PHP e o modo de depuração precisa estar ativado.

Solução recomendada: Defina o executor da CLI como PHP e garanta que o modo de depuração esteja ativado.

Erros do GLIBC relacionados ao Node.js

Problema: Os usuários não conseguem executar o Node.js e estão recebendo erros do GLIBC. Um exemplo dessas mensagens de erro está descrito abaixo:

node: /lib64/libm.so.6: version `GLIBC_2.27' not found (required by node) node: /lib64/libc.so.6: version `GLIBC_2.28' not found (required by node)

Causa: Potencialmente, podem ser problemas na versão do Node.js relacionados à instância que está sendo usada.

Solução recomendada: Consulte a seção Etapa 1: Instalar as ferramentas necessárias para obter informações sobre como instalar o Node.js para AWS Cloud9.