

 AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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á.

# Criar serviços do App Runner
<a name="creating-service-apprunner"></a>

**Você pode criar um serviço App Runner no AWS Toolkit usando o AWS Explorer.** Depois de escolher criar um serviço em um específico Região da AWS, o painel de comando do AWS Toolkit descreve como configurar a instância do serviço em que seu aplicativo é executado. 

Antes de criar um serviço do App Runner, verifique se você atendeu aos [pré-requisitos](using-apprunner.md#apprunner-prereqs). Isso inclui fornecer as permissões relevantes do IAM e confirmar o repositório-fonte específico que você deseja implantar.<a name="create-service"></a>

# Para criar um serviço do App Runner
<a name="create-service"></a>

1. Abra o AWS Explorer, se ele ainda não estiver aberto.

1. Clique com o botão direito do mouse no nó do **App Runner** e escolha **Create Service** (Criar serviço).

   O painel de comando do AWS Toolkit é exibido.

1. Para **Select a source code location type** (Selecionar um tipo de localização de código-fonte), escolha **ECR** ou **Repository** (Repositório). 

   Se escolher **ECR**, você especificará uma imagem de contêiner em um repositório mantido pelo Amazon Elastic Container Registry. Se escolher **Repository** (Repositório), você especificará um repositório de códigos-fonte mantido por um provedor de repositórios compatível. Atualmente, o App Runner oferece suporte [GitHub](https://github.com/)como provedor de repositório de código-fonte. 

## Implantar do ECR
<a name="deploying-from-ECR"></a>

1. Para **Select or enter an image repository** (Selecionar ou inserir um repositório de imagens), escolha ou insira a URL do repositório de imagens mantido pelo registro privado do Amazon ECR ou pela Amazon ECR Public Gallery.
**nota**  
Se você especificar um repositório da Amazon ECR Public Gallery, verifique se as implantações automáticas estão desativadas. O App Runner não é compatível com implantações automáticas de imagens de um repositório público do ECR.  
As implantações automáticas são desativadas por padrão. Isso é indicado quando o ícone no cabeçalho do painel de comandos está cruzado por uma linha diagonal. Se você escolher ativar implantações automáticas, uma mensagem informará que essa opção pode gerar custos adicionais. 

1. Se a etapa no painel de comandos informar **No tags found** (Nenhuma etiqueta encontrada), volte uma etapa para selecionar um repositório que contenha uma imagem de contêiner marcada.

1. Para **Port** (Porta), insira a porta IP usada pelo serviço (porta `8000`, por exemplo).

1. (Opcional) Em **Configure environment variables** (Configurar variáveis de ambiente), especifique um arquivo que contenha as variáveis de ambiente usadas para personalizar o comportamento na instância do serviço.

1. Se você estiver usando um registro privado do Amazon ECR, precisará da **AppRunnerECRAccessfunção de acesso Role** ECR. Essa função permite que o App Runner acesse imagens do Amazon Elastic Container Registry (Amazon ECR) em sua conta. Escolha o ícone “\+” no cabeçalho do painel de comando para criar essa função. Se sua imagem estiver armazenada no Amazon ECR público, onde as imagens estão disponíveis ao público, não será necessária uma função de acesso.

1. Em **Name your service** (Fornecer nome ao serviço), insira um nome exclusivo e pressione **Enter**. O nome não pode conter espaços.

1. Em **Select instance configuration** (Selecionar a configuração da instância), selecione uma combinação de unidades de CPU e memória (ambas em GB) para a instância do serviço.

   Quando o serviço está sendo criado, o status é alterado de **Creating** (Sendo criado) para **Running** (Em execução).

1.  Depois que o serviço começar a ser executado, abra o menu de contexto (clique com o botão direito do mouse) e selecione **Copy Service URL** (Copiar URL do serviço). 

1. Para acessar a aplicação implantada, cole a URL copiada na barra de endereços do navegador da Web. 

## Implantar de um repositório remoto
<a name="deploying-from-repository"></a>

1.  Em **Selecionar uma conexão**, escolha uma conexão GitHub vinculada AWS a. As conexões que estão disponíveis para seleção estão listadas na página de **GitHub conexões** no console do App Runner. 

1.  Em **Selecionar um GitHub repositório remoto**, escolha ou insira uma URL para o repositório remoto.

    Repositórios remotos que já estão configurados com o gerenciamento de controle de AWS Cloud9 origem estão disponíveis para seleção. Se o repositório não estiver listado, você também poderá colar um link para o repositório.

1. Para **Select a branch** (Selecionar uma ramificação), escolha qual ramificação Git do código-fonte você deseja implantar.

1. Para **Choose configuration source** (Escolher fonte de configuração), especifique como você deseja definir a configuração de tempo de execução.

   Se escolher **Use configuration file** (Usar arquivo de configuração), a instância do serviço será definida pelas configurações do arquivo de configuração `apprunner.yaml`. Esse arquivo está no diretório raiz do repositório da aplicação.

   Se escolher **Configure all settings here** (Definir todas as configurações aqui), use o painel de comandos para especificar o seguinte:
   + **Runtime** (Tempo de execução): escolha **Python 3** ou **Nodejs 12**.
   + **Build command** (Comando Build): insira o comando para compilar a aplicação no ambiente do tempo de execução da instância do serviço.
   + **Comando Start**: insira o comando para compilar a aplicação no ambiente do runtime da instância do serviço.

1. Para **Port** (Porta), insira a porta IP usada pelo serviço (porta `8000`, por exemplo).

1. (Opcional) Em **Configure environment variables**, (Configurar variáveis de ambiente), especifique um arquivo que contenha as variáveis de ambiente usadas para personalizar o comportamento na instância do serviço.

1. Em **Name your service** (Fornecer nome ao serviço), insira um nome exclusivo e pressione **Enter**. O nome não pode conter espaços.

1. Para **Select instance configuration** (Selecionar a configuração da instância), escolha uma combinação de unidades de CPU e memória em GB para a instância do serviço.

   Quando o serviço está sendo criado, o status é alterado de **Creating** (Sendo criado) para **Running** (Em execução).

1. Depois que o serviço começar a ser executado, abra o menu de contexto (clique com o botão direito do mouse) dele e selecione **Copy Service URL** (Copiar URL do serviço).

1. Para acessar a aplicação implantada, cole o URL copiado na barra de endereços do navegador da web.

**nota**  
Se a tentativa de criar um serviço do App Runner falhar, o serviço exibirá um status de **Create failed** (Falha na criação) no **AWS Explorer**. Para obter informações de solução de problemas, consulte [When service creation fails](https://docs.aws.amazon.com/apprunner/latest/dg/manage-create.html#manage-create.failure) (Quando a criação do serviço falha) no *App Runner Developer Guide* (Guia do desenvolvedor do App Runner).