

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

Você pode criar um serviço do App Runner no AWS Toolkit for JetBrains usando a caixa de diálogo **Criar serviço do App Runner**. Você pode usar a interface para selecionar um repositório de origem e configurar a instância de serviço em que sua aplicação é executada. 

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 anotar as informações específicas sobre o repositório de origem 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 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 caixa de diálogo **Criar serviço do App Runner** é exibida.

1. Insira seu **Nome de serviço** exclusivo.

1. Escolha seu tipo de fonte (**ECR**, **ECR Public** ou **Repositório de código-fonte**) e defina as configurações relevantes:

------
#### [ ECR/ECR public ]

   Se você estiver usando um registro privado, escolha o **Tipo de implantação**:
   + **Manual**: use a implantação manual se você quiser iniciar explicitamente cada implantação no seu serviço. 
   + **Automático**: use a implantação automática se você quiser implantar o comportamento de integração e implantação contínuas (CI/CD) para seu serviço. Se você escolher essa opção, significa que, sempre que enviar um novo versionamento de imagem para seu repositório de imagens ou uma nova confirmação para seu repositório de código, o App Runner a implantará automaticamente em seu serviço sem que você precise fazer mais nada.

   Para **URI da imagem de contêiner**, insira o URI do repositório de imagens que você copiou do seu registro privado do Amazon ECR ou do Amazon ECR Public Gallery.

   Para **Iniciar comando**, digite o comando para iniciar o processo do serviço.

   Para **Porta**, insira a porta IP usada pelo serviço.

   Se você estiver usando um registro privado do Amazon ECR, selecione o **Perfil de acesso do ECR** necessário e escolha **Criar**.
   + A caixa de diálogo **Criar perfil do IAM** exibe **Nome**, **Políticas gerenciadas** e **Relações de confiança** para o perfil do IAM. Escolha **Create** (Criar).

------
#### [ Source code repository ]

   Escolha o **Tipo de implantação**:
   + **Manual**: use a implantação manual se você quiser iniciar explicitamente cada implantação no seu serviço. 
   + **Automático**: use a implantação automática se você quiser implantar o comportamento de integração e implantação contínuas (CI/CD) para seu serviço. Se você escolher essa opção, significa que, sempre que enviar um novo versionamento de imagem para seu repositório de imagens ou uma nova confirmação para seu repositório de código, o App Runner a implantará automaticamente em seu serviço sem você precise fazer mais nada.

   Para **Conexões**, selecione uma conexão que esteja disponível na lista na página **Conexões do GitHub**.

   Para **URL do repositório**, insira o link para o repositório remoto que está no host do GitHub.

   Para **Ramificação**, indique qual ramificação Git do código-fonte você deseja implantar.

   Para **Configuração**, especifique como você deseja definir sua configuração de runtime:
   + **Definir todas as configurações aqui**: escolha esta opção se quiser especificar as seguintes configurações para o ambiente de runtime da sua aplicação: 
     + **Runtime**: escolha **Python 3** ou **Nodejs 12**.
     + **Porta**: insira a porta IP que seu serviço usa.
     + **Comando Build**: insira o comando para compilar a aplicação no ambiente do runtime 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.
   + **Fornecer as configurações de um arquivo de configuração aqui**: escolha esta opção para usar as configurações definidas pelo arquivo de configuração `apprunner.yaml`. Esse arquivo está no diretório raiz do repositório da aplicação.

------

1. Especifique os valores para definir a configuração de runtime da instância do serviço do App Runner: 
   + **CPU**: o número de unidades de CPU reservadas para cada instância do seu serviço do App Runner (padrão: `1 vCPU`).
   + **Memória:** a quantidade de memória reservada para cada instância do seu serviço do App Runner (padrão: `2 GB`)
   + **Variáveis de ambiente**: variáveis de ambiente opcionais usadas para personalizar o comportamento na instância do seu serviço. Crie variáveis de ambiente definindo uma chave e um valor.

1. Escolha **Create** (Criar)

   Quando o serviço está sendo criado, o status é alterado de **Operação em andamento** para **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.