Solução de problemas AWS Cloud9 - AWS Cloud9
Installer (Instalador)AWS Cloud9 Meio ambienteAmazon EC2Outros AWS serviçosPré-visualização da aplicaçãoPerformanceAplicativos e serviços de terceiros

AWS Cloud9 não está mais disponível para novos clientes. Os clientes existentes do AWS Cloud9 podem continuar usando o serviço normalmente. Saiba mais”

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 AWS Cloud9

Use as informações a seguir para identificar e resolver problemas com 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 AWS Cloud9 instalador trava ou falha

Problema: quando você baixa e executa o AWS Cloud9 instalador, ocorre um ou mais erros e o script do instalador não é exibidoDone.

Causa: O AWS Cloud9 instalador encontrou um ou mais erros dos quais não consegue se recuperar e, como resultado, 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.

AWS Cloud9 o instalador não termina após exibir: “Package Cloud9 IDE 1"

Problema: AWS Cloud9 está instalado em sua instância existente do Amazon EC2 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 AWS Cloud9 os pacotes 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 do Node.js mais recente compatível com o sistema operacional do host. Se você tiver uma versão do Node.js seu host que AWS Cloud9 não é compatível, pode ocorrer um erro de instalação.

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

Falha ao instalar as dependências

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

Causas possíveis:

  • Se seu AWS Cloud9 ambiente estiver usando um proxy para acessar a Internet, AWS Cloud9 precisará dos detalhes do proxy para instalar dependências. Se você não forneceu os detalhes do proxy para 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 seus detalhes de proxy AWS Cloud9, anexe o seguinte código ao arquivo de ambientes~/.bashrc:

    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 for https://172.31.26.80:3129, adicione as linhas a seguir ao seu arquivo ~/.bashrc e defina NODE_EXTRA_CA_CERTS como 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 endpoints da VPC da Amazon 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: Depois de abrir um ambiente de desenvolvimento AWS Cloud9 SSH, o terminal no AWS Cloud9 IDE exibe uma mensagem que começa com “A versão 3 do Python é necessária 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:

AWS Cloud9 Meio ambiente

A seção a seguir descreve a solução de problemas relacionados ao ambiente do 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 AWS Cloud9 desenvolvimento, aparece uma mensagem com a frase “Não conseguimos criar instâncias EC2 em sua conta durante a verificação e ativação da conta”.

Causa: AWS está atualmente verificando e ativando seu. 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: “Não autorizado a realizar sts:AssumeRole”

Problema: ao tentar criar um novo ambiente, você vê este erro: “Não autorizado a realizar sts:AssumeRole” e o ambiente não é criado.

Possíveis causas: Não existe uma função AWS Cloud9 vinculada ao serviço no seu. Conta da AWS

Soluções recomendadas: Crie uma função AWS Cloud9 vinculada a serviços em seu. 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 você não conseguir fazer isso, verifique com seu Conta da AWS administrador.

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

Identidades federadas não podem criar ambientes

Problema: quando você tenta usar uma identidade AWS federada para criar um ambiente de AWS Cloud9 desenvolvimento, uma mensagem de erro de acesso é exibida e o ambiente não é criado.

AWS Cloud9 Causa: 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 GetFederationTokena Referência AWS Security Token Service da API.

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

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 AWS Cloud9 console para criar ou gerenciar um ambiente de AWS Cloud9 desenvolvimento, você vê um erro que contém uma frase semelhante a “arn:aws:iam::123456789012:user/MyUserO usuário não está autorizado a 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ê entrou no AWS Cloud9 console não tem as permissões de AWS acesso corretas para realizar 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 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 ~/ .ssh/authorized_keys arquivo, remover as AWS Cloud9 chaves desse arquivo ou remover o arquivo completamente, 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 AWS Cloud9 console não tem as permissões de AWS acesso necessárias para abrir o ambiente.

  • Se o ambiente estiver associado a uma instância de computação AWS em nuvem (por exemplo, uma instância do Amazon EC2), o possível pode ser verdadeiro:

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

    • A instância está fazendo a transição entre estados ou está falhando nas verificações automatizadas de status ao tentar AWS Cloud9 se conectar à instância.

  • Se o ambiente for um ambiente SSH, a instância de computação em nuvem associada ou seu próprio servidor não estão configurados corretamente para permitir o acesso AWS Cloud9 a ela.

Soluções recomendadas:

Não é possível abrir o AWS Cloud9 ambiente: “Esse ambiente não pode ser acessado atualmente pelos 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: se um novo colaborador for adicionado a um ambiente por alguém que não seja o proprietário do ambiente, as credenciais temporárias AWS gerenciadas serão desativadas. As credenciais são desabilitadas quando você exclui o arquivo ~/.aws/credentials. Enquanto o ~/.aws/credentials arquivo está sendo excluído, novos colaboradores não podem acessar o AWS Cloud9 ambiente.

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 ter mais informações, consulte Controlar o acesso às credenciais temporárias gerenciadas pela AWS.

Soluções recomendadas: aguarde até que o ~/.aws/credentials arquivo seja totalmente excluído antes de tentar abrir o AWS Cloud9 ambiente novamente. 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 AWS Cloud9 console, é exibida uma mensagem que diz “falha na exclusão de um ou mais ambientes” e pelo menos um dos ambientes não é excluído.

Possível causa: AWS CloudFormation pode ter um problema ao excluir um ou mais dos ambientes. AWS Cloud9 depende AWS CloudFormation da criação e exclusão de ambientes.

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

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

  2. Na barra AWS de navegação, escolha o Região da AWS para o ambiente.

  3. Na lista de AWS CloudFormation pilhas, selecione a entrada em que o nome da pilha contém o nome do ambiente não excluído e o status é DELETE_FAILED. Por exemplo, se o nome do ambiente formy-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

Excluir manualmente os recursos de uma pilha com falha não remove a pilha em si da sua. Conta da AWS

Para excluir manualmente esses recursos, faça o seguinte. No AWS CloudFormation console, escolha a pilha com falha e selecione a seção Recursos. Acesse o console AWS de cada recurso dessa lista e, em seguida, use esse 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 Preferências do AWS Cloud9.

  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 aplicativos SAM localmente no AWS Toolkit porque o AWS Cloud9 ambiente não tem espaço em disco suficiente

Problema: ocorre um erro quando você usa o AWS Toolkit para executar comandos AWS SAM CLI para aplicativos definidos pelos modelos do SAM.

Possíveis causas: Quando você executa e depura aplicativos sem servidor localmente com o AWS Toolkit, usa imagens. AWS SAM 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: o HTTP403: FORBIDDEN erro é retornado ao tentar carregar o AWS Cloud9 IDE usando o navegador Microsoft Edge da web.

Possíveis causas: O AWS Cloud9 IDE não oferece suporte a determinadas versões mais antigas doMicrosoft 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 AWS Cloud9 IDE File Explorer, 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. AWS Cloud9 Você não poderá acessar nenhum arquivo dentro desse diretório a partir do Explorador de Arquivos do AWS Cloud9 IDE, 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 AWS Cloud9 IDE File Explorer.

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 para. AWS Cloud9 CodeCatalyst

Problema: Ao criar a estrutura de subpastas /projects/projects no AWS Cloud9 IDE File Explorer 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/projetos dentro de uma pasta com o mesmo nome usando o Explorador de Arquivos do AWS Cloud9 IDE para. CodeCatalyst Você não poderá acessar nenhum arquivo dentro desse diretório a partir do Explorador de Arquivos do AWS Cloud9 IDE, 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 AWS Cloud9 IDE File Explorer for 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 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.

Possíveis causas: Um terminal que não responde pode ser causado por um erro tmux. 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. Outra solução recomendada é usar AWS Systems Manager para definir uma configuração de gerenciamento de host. Isso permite acesso à instância relevante por meio do console do Amazon EC2.

Configurar o gerenciamento de host

  1. Primeiro, no AWS Cloud9 console, encontre o nome da instância do 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 AWS Systems Manager console 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 AWS Cloud9 desenvolvimento.

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 atualizações do sistema à instância do Amazon EC2 regularmente seguindo as instruções em Atualização do software da instância no Guia do usuário do Amazon EC2.

Para executar comandos na instância, você pode usar uma sessão de terminal no AWS Cloud9 IDE a partir do ambiente 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 AWS Cloud9 IDE do ambiente 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.

AWS CLI ou erro AWS-shell: “O token de segurança incluído na solicitação é inválido” em um ambiente EC2

Problema: Quando você tenta usar o AWS Command Line Interface (AWS CLI) ou o AWS-shell para executar um comando no AWS Cloud9 IDE para um ambiente EC2, aparece um erro: “O token de segurança incluído 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 AWS gerenciadas. Para obter uma lista de comandos permitidos, consulte Ações suportadas por credenciais temporárias AWS gerenciadas.

  • As credenciais temporárias AWS gerenciadas expiraram automaticamente após 15 minutos.

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

Soluções recomendadas:

  • Execute somente os comandos permitidos pelas credenciais temporárias AWS gerenciadas. Se você precisar executar um comando que não é permitido pelas credenciais temporárias AWS gerenciadas, configure o AWS CLI or 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, certifique-se de que o proprietário do ambiente abra o ambiente para que AWS Cloud9 possa atualizar as credenciais temporárias no ambiente. Para ter 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 contêineres conectados à mesma rede de ponte se comuniquem. AWS Cloud9 cria contêineres que usam uma ponte padrão para comunicação de contêineres. 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 AWS Cloud9 impede a conexão com a instância do EC2 que dá suporte ao 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 AWS Cloud9 IDE File Explorer, 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. AWS Cloud9 Você não poderá acessar nenhum arquivo dentro desse diretório a partir do Explorador de Arquivos do AWS Cloud9 IDE, 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 AWS Cloud9 IDE File Explorer.

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

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

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

Possíveis causas: AWS License Manager simplifica o gerenciamento de licenças de fornecedores de software em todo o. 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 Amazon Machine Image (AMI) ou AWS CloudFormation. Você pode usar um desses mecanismos para iniciar instâncias do EC2.

Atualmente, as versões mais antigas da função vinculada ao serviço (SLR) AWSServiceRoleForAWSCloud 9 não incluem a condição do license-configuration recurso. AWSCloud9ServiceRolePolicy Por causa disso, AWS Cloud9 não tem permissão para iniciar e parar sua instância. Portanto, AWS Cloud9 é negado o acesso à sua instância do Amazon EC2 e um erro é retornado.

Soluções recomendadas: Se você não conseguir acessar um AWS Cloud9 ambiente existente e usar o License Manager, substitua a antiga função AWSCloud9ServiceRolePolicyvinculada ao serviço pela versão da SLR que permite explicitamente ações do EC2 quando a se aplica à instância. license-configuration É 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 AWS Cloud9 EC2, você não pode instalar alguns tipos de pacotes, executar comandos como yum ou apt ou executar scripts contendo comandos que normalmente funcionam com outros sistemas operacionais Linux.

AWS Cloud9 Causa: As instâncias do Amazon EC2 usadas 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 “ AWSCloud9SSMInstanceProfile O perfil da instância não existe na conta” ao criar o ambiente EC2 usando AWS CloudFormation

Problema: ao usar o AWS CloudFormation recurso AWS::Cloud9::EnvironmentEC2 para criar um ambiente EC2, os usuários recebem uma mensagem de erro informando que AWSCloud9SSMInstanceProfileo perfil da instância 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. Mas ao usar AWS CloudFormation ou AWS CLI criar seu primeiro ambiente sem entrada, você deve criar esses recursos do IAM manualmente.

Solução recomendada: para obter informações sobre como editar seu AWS CloudFormation modelo 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 AWS CloudFormation recurso AWS::Cloud9::EnvironmentEC2 para criar um ambiente EC2, os usuários recebem uma AccessDeniedException e são informados de que “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 seu AWS CloudFormation modelo e atualizar as permissões do IAM, consulteUsar 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 do EC2 usando a AWS CLI

Problema: ao usar o AWS CLIpara criar um ambiente EC2, os usuários recebem um AccessDeniedException e são informados de que seu AWS Cloud9 ambiente não está autorizado a “executar iam: GetInstanceProfile on resource: instance profileAWSCloud9SSMInstanceProfile”.

Causa: AWS Cloud9 não tem permissão para chamar a StartSession API 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 adicionar a função AWSCloud9SSMAccessRole de serviço necessária e AWSCloud9SSMInstanceProfile ao seu AWS Cloud9 ambiente, consulteGerenciar 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: o 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 seu AWS Cloud9 IDE usa volumes do Amazon EBS que, por padrão, são criptografados, a função AWS Identity and Access Management vinculada ao serviço AWS Cloud9 exigirá acesso ao AWS KMS keys para esses volumes do EBS. Se o acesso não for fornecido, o AWS Cloud9 IDE pode falhar ao iniciar e pode ser difícil depurar o problema.

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

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

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ê usa um Conta da AWS que foi configurado antes de 4 de dezembro de 2013, esse erro pode ocorrer se você não configurar uma Amazon VPC e uma sub-rede ao criar um ambiente de desenvolvimento AWS Cloud9 EC2.

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 AWS CloudFormation para visualizar o histórico de eventos da pilha para o ambiente de desenvolvimento.

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

  2. No AWS CloudFormation console, escolha Stacks.

  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 AssociatePublicIpAddress parâmetro só é compatível com lançamentos de VPC. [...]

Causa: Um ambiente de AWS Cloud9 desenvolvimento deve estar 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 AWS serviços

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

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

Problema: Ao criar a estrutura de subpastas /projects/projects no AWS Cloud9 IDE File Explorer 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/projetos dentro de uma pasta com o mesmo nome usando o Explorador de Arquivos do AWS Cloud9 IDE para. CodeCatalyst Você não poderá acessar nenhum arquivo dentro desse diretório a partir do Explorador de Arquivos do AWS Cloud9 IDE, 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 AWS Cloud9 IDE File Explorer for 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.

  • O aplicativo está sendo executado em um ambiente de desenvolvimento AWS Cloud9 EC2. 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.

  • O aplicativo está sendo executado em um ambiente de desenvolvimento AWS Cloud9 SSH para uma instância de computação AWS em nuvem (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 o aplicativo esteja sendo executado em uma instância de computação em AWS nuvem (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 o aplicativo esteja sendo executado em uma instância de computação em AWS nuvem. 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 uma URL com o formato https://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/ (onde 12a34567b8cd9012345ef67abcd890e1 está a ID AWS Cloud9 atribuída ao ambiente e us-east-2 a ID da AWS região do 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 ter mais informações, consulte Compartilhar uma aplicação em execução pela Internet.

  • Suponha que o aplicativo esteja sendo executado em uma instância de computação em AWS nuvem. 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, pode haver algum outro problema que não esteja relacionado AWS Cloud9 a.

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

Problema: um utilitário de monitoramento de arquivos usado pelo AWS Toolkit está se aproximando do limite atual ou da cota de arquivos que ele pode monitorar.

Causa: O AWS Toolkit usa um utilitário de monitoramento 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. Insira o comando da a seguir.

    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 AWS Lambda função no AWS Cloud9 IDE, uma caixa de diálogo é exibida. A caixa de diálogo indica que AWS Cloud9 está tendo problemas para instalar o SAM Local. AWS Cloud9 precisa do SAM Local para executar versões locais das AWS Lambda funções 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: não AWS Cloud9 consigo encontrar o SAM Local no caminho esperado no ambiente, que é~/.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: Você pode esperar AWS Cloud9 para tentar concluir a instalação do SAM Local ou você mesmo pode instalá-lo.

Para ver como AWS Cloud9 está a tentativa de instalar o SAM Local, escolha Janela, Instalador na barra de menu.

Para instalar você mesmo o SAM Local, siga as instruções em Instalando a CLI do AWS SAM no Linux no Guia do AWS Serverless Application Model Desenvolvedor.

AWS Control Tower erro ao tentar criar um ambiente Amazon EC2 usando AWS Cloud9: “A criação do ambiente falhou com o erro: The following hook (s) failed (s): [: :GuardControlTower: :Hook].”

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

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

Solução recomendada: desative o controle CT.EC2.PR.8 do AWS Control Tower console 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: o 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 seu AWS Cloud9 IDE usa volumes do Amazon EBS que, por padrão, são criptografados, a função AWS Identity and Access Management vinculada ao serviço AWS Cloud9 exigirá acesso ao AWS KMS keys para esses volumes do EBS. Se o acesso não for fornecido, o AWS Cloud9 IDE pode falhar ao iniciar e pode ser difícil depurar o problema.

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

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

(Voltar ao início)

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

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

Possíveis causas: AWS License Manager simplifica o gerenciamento de licenças de fornecedores de software em todo o. 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 Amazon Machine Image (AMI) ou AWS CloudFormation. Você pode usar um desses mecanismos para iniciar instâncias do EC2.

Atualmente, as versões mais antigas da função vinculada ao serviço (SLR) AWSServiceRoleForAWSCloud 9 não incluem a condição do license-configuration recurso. AWSCloud9ServiceRolePolicy Por causa disso, AWS Cloud9 não tem permissão para iniciar e parar sua instância. Portanto, AWS Cloud9 é negado o acesso à sua instância do Amazon EC2 e um erro é retornado.

Soluções recomendadas: Se você não conseguir acessar um AWS Cloud9 ambiente existente e usar o License Manager, substitua a antiga função AWSCloud9ServiceRolePolicyvinculada ao serviço pela versão da SLR que permite explicitamente ações do EC2 quando a se aplica à instância. license-configuration É 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 da aplicação

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

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 seu código pode usar tanta memória que o AWS Cloud9 IDE pode pausar ou parar quando a visualização prévia do aplicativo estiver em execução. Para evitar que isso aconteça, AWS Cloud9 não recarregue as guias de visualização do aplicativo 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 AWS Cloud9 IDE. 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.

AWS Region 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

South America (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 AWS Cloud9 IDE tenta acessar seu 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 o conteúdo da web, como um WordPress site hospedado em um ambiente AWS Cloud9 EC2, 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 do aplicativo do AWS Cloud9 IDE usam 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: Quando você tenta usar o AWS Cloud9 IDE para visualizar um arquivo que contém um <script> elemento que contém o src atributo e com o type atributo definido comomodule, ocorre um erro 499 e o script não é executado conforme o esperado.

Causa: As solicitações de busca de visualização de arquivos no AWS Cloud9 IDE exigem que os cookies sejam enviados pelo navegador da Web para 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.

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

Problema: Durante a inicialização e ao realizar uma atualização, o terminal AWS Cloud9 IDE 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 CodeLenses que o AWS Toolkit 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 AWS Cloud9 console (por exemplo, ao abrir o IDE ou atualizar a página da web do IDE), você vê esta mensagem: “Uma ou mais sessões ou colaboradores estão ativos neste ambiente. 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 excessivo de recursos, especialmente em instâncias pequenas, como t2.nano et2.micro, AWS Cloud9 mude para o mecanismo mínimo de preenchimento 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

Escolher uma instância maior do Amazon EC2 pode fazer com que você incorra em Conta da AWS cobranças adicionais. Para obter mais informações, consulte Preço 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 AWS Cloud9 IDE

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

Causa: AWS Cloud9 reduz a velocidade de upload para o AWS Cloud9 IDE 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. 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 AWS Cloud9 IDE

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

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 AWS Cloud9 seu IDE 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 o conteúdo da web, como um WordPress site hospedado em um ambiente AWS Cloud9 EC2, 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 do aplicativo do AWS Cloud9 IDE usam 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 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.

Possíveis causas: Um terminal que não responde pode ser causado por um erro tmux. 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. Outra solução recomendada é usar AWS Systems Manager para definir uma configuração de gerenciamento de host. Isso permite acesso à instância relevante por meio do console do Amazon EC2.

Configurar o gerenciamento de host

  1. Primeiro, no AWS Cloud9 console, encontre o nome da instância do 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 AWS Systems Manager console 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: o HTTP403: FORBIDDEN erro é retornado ao tentar carregar o AWS Cloud9 IDE usando o navegador Microsoft Edge da web.

Possíveis causas: O AWS Cloud9 IDE não oferece suporte a determinadas versões mais antigas doMicrosoft 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.

Causas possíveis: suponha que seu AWS Cloud9 ambiente use determinados tipos de instância do EC2 (por exemplo, t3.small oum5.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 seguinte comando no terminal. 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 PHP runner 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 habilitado.

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: é provável que sejam 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.