

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 do App Runner no kit de ferramentas para VS Code usando o **AWS Explorer** e a **Paleta de comandos** do VS Code. Depois de escolher criar um serviço em uma AWS região específica, as etapas numeradas fornecidas pela **Paleta de Comandos** orientam você pelo processo de configuração da instância de 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).

   A **paleta de comandos** é exibida.

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 especificar um repositório da Amazon ECR Public Gallery, verifique se as implantações automáticas estão desativadas, porque o App Runner não dá suporte a 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, e isso é indicado quando o ícone no cabeçalho da **paleta 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 da **paleta de comandos** informar que **Nenhuma tag foi encontrada**, será necessário voltar uma etapa para selecionar um repositório que contenha uma imagem de contêiner marcada.

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

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

1. Para **Configure environment variables**, (Configurar variáveis de ambiente), você pode especificar um arquivo que contém as variáveis de ambiente usadas para personalizar o comportamento na instância do serviço. Ou pode ignorar essa etapa.

1. Para **Name your service** (Dar nome ao serviço), insira um nome exclusivo sem espaços e pressione **Enter**.

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, clique com o botão direito do mouse e escolha **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 origem (SCM) do Visual Studio Code estão disponíveis para seleção. Você também pode colar um link para o repositório se ele não estiver listado.

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 você escolher **Defina todas as configurações aqui**, use a **paleta 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.
   + **Start command** (Comando Start): insira o comando para compilar a aplicação no ambiente do tempo de execução da instância do serviço.

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

1. Para **Configure environment variables**, (Configurar variáveis de ambiente), você pode especificar um arquivo que contém as variáveis de ambiente usadas para personalizar o comportamento na instância do serviço. Ou pode ignorar essa etapa.

1. Para **Name your service** (Dar nome ao serviço), insira um nome exclusivo sem espaços e pressione **Enter**.

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, clique com o botão direito do mouse e escolha **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 dicas para a 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).