AWS App Runner não estará mais aberto a novos clientes a partir de 30 de abril de 2026. Se você quiser usar o App Runner, inscreva-se antes dessa data. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Mudança de disponibilidade do AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
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á.
# Usando AWS CloudShell para trabalhar com AWS App Runner
AWS CloudShell é um shell pré-autenticado baseado em navegador que você pode iniciar diretamente do. Console de gerenciamento da AWS Você pode executar AWS CLI comandos em AWS serviços (inclusive AWS App Runner) usando seu shell preferido (Bash PowerShell ou Z shell). E você pode fazer isso sem precisar baixar ou instalar ferramentas de linha de comando.
Você [inicia a AWS CloudShell partir do Console de gerenciamento da AWS](https://docs.aws.amazon.com/cloudshell/latest/userguide/working-with-cloudshell.html#launch-options), e AWS as credenciais que você usou para entrar no console estão automaticamente disponíveis em uma nova sessão de shell. Essa pré-autenticação de AWS CloudShell usuários permite que você ignore a configuração de credenciais ao interagir com AWS serviços como o App Runner usando a AWS CLI versão 2 (pré-instalada no ambiente computacional do shell).
**Topics**
+ [Obtendo permissões do IAM para AWS CloudShell](#api-cshell.permissions)
+ [Interagindo com o App Runner usando AWS CloudShell](#api-cshell.call-apprunner)
+ [Verificando seu serviço App Runner usando AWS CloudShell](#api-cshell.call-your-service)
## Obtendo permissões do IAM para AWS CloudShell
Usando os recursos de gerenciamento de acesso fornecidos por AWS Identity and Access Management, os administradores podem conceder permissões aos usuários do IAM para que eles possam acessar AWS CloudShell e usar os recursos do ambiente.
A maneira mais rápida de um administrador conceder acesso aos usuários é por meio de uma política AWS gerenciada. Uma [política gerenciada pela AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) é uma política independente que é criada e administrada pela AWS. A seguinte política AWS gerenciada para CloudShell pode ser anexada às identidades do IAM:
+ `AWSCloudShellFullAccess`: concede permissão para uso AWS CloudShell com acesso total a todos os recursos.
Se você quiser limitar o escopo das ações que um usuário do IAM pode realizar AWS CloudShell, crie uma política personalizada que use a política `AWSCloudShellFullAccess` gerenciada como modelo. Para obter mais informações sobre como limitar as ações que estão disponíveis para os usuários em CloudShell, consulte [Gerenciamento de AWS CloudShell acesso e uso com políticas do IAM](https://docs.aws.amazon.com/cloudshell/latest/userguide/sec-auth-with-identities.html) no *Guia do AWS CloudShell usuário*.
**nota**
Sua identidade do IAM também exige uma política que conceda permissão para fazer chamadas para o App Runner. Para obter mais informações, consulte [Como o App Runner funciona com o IAM](security_iam_service-with-iam.md).
## Interagindo com o App Runner usando AWS CloudShell
Depois AWS CloudShell de iniciar a partir do Console de gerenciamento da AWS, você pode começar imediatamente a interagir com o App Runner usando a interface de linha de comando.
No exemplo a seguir, você recupera informações sobre um dos seus serviços do App Runner usando o AWS CLI in. CloudShell
**nota**
Ao usar o AWS CLI in AWS CloudShell, você não precisa baixar ou instalar nenhum recurso adicional. Além disso, como você já está autenticado no shell, não precisará configurar as credenciais antes de fazer chamadas.
**Example Recuperando informações do serviço App Runner usando AWS CloudShell**
1. A partir do Console de gerenciamento da AWS, você pode iniciar CloudShell escolhendo as seguintes opções disponíveis na barra de navegação:
+ Escolha o CloudShell ícone.
+ Comece a digitar **cloudshell** na caixa de pesquisa e escolha a **CloudShell**opção ao vê-la nos resultados da pesquisa.
1. Para listar todos os serviços atuais do App Runner em sua AWS conta na AWS região da sessão do console, digite o seguinte comando na linha de CloudShell comando:
```
$ aws apprunner list-services
```
A saída lista informações resumidas de seus serviços.
```
{
"ServiceSummaryList": [
{
"ServiceName": "my-app-1",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"Status": "RUNNING"
},
{
"ServiceName": "my-app-2",
"ServiceId": "ab8f94cfe29a460fb8760afd2ee87555",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-2/ab8f94cfe29a460fb8760afd2ee87555",
"ServiceUrl": "e2m8rrrx33.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-06T23:15:30Z",
"UpdatedAt": "2020-11-23T13:21:22Z",
"Status": "RUNNING"
}
]
}
```
1. Para obter uma descrição detalhada de um serviço específico do App Runner, digite o seguinte comando na linha de CloudShell comando, usando um dos ARNs recuperados na etapa anterior:
```
$ aws apprunner describe-service --service-arn arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa
```
A saída lista uma descrição detalhada do serviço que você especificou.
```
{
"Service": {
"ServiceName": "my-app-1",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"Status": "RUNNING",
"SourceConfiguration": {
"CodeRepository": {
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
},
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "[pip install -r requirements.txt]",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "API"
}
},
"AutoDeploymentsEnabled": true,
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-2:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
}
},
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
},
"HealthCheckConfiguration": {
"Protocol": "TCP",
"Path": "/",
"Interval": 10,
"Timeout": 5,
"HealthyThreshold": 1,
"UnhealthyThreshold": 5
},
"AutoScalingConfigurationSummary": {
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-2:123456789012:autoscalingconfiguration/DefaultConfiguration/1/00000000000000000000000000000001",
"AutoScalingConfigurationName": "DefaultConfiguration",
"AutoScalingConfigurationRevision": 1
}
}
}
```
## Verificando seu serviço App Runner usando AWS CloudShell
Quando você [cria um serviço do App Runner](manage-create.md), o App Runner cria um domínio padrão para o site do seu serviço e o mostra no console (ou o retorna no resultado da chamada da API). Você pode usar CloudShell para fazer chamadas para seu site e verificar se ele está funcionando corretamente.
Por exemplo, depois de criar um serviço App Runner conforme descrito em[Introdução ao App Runner](getting-started.md), execute o seguinte comando em CloudShell:
```
$ curl https://qxuadi4qwp.us-east-2.awsapprunner.com/; echo
```
A saída deve mostrar o conteúdo esperado da página.
![\[Janela do navegador exibida AWS CloudShell com um comando para exibir o conteúdo de uma página de serviço do App Runner\]](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/api-cshell-curl.png)