

AWS App Runner dejará de estar abierto a nuevos clientes a partir del 30 de abril de 2026. Si quieres usar App Runner, regístrate antes de esa fecha. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cambio en la disponibilidad de AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Uso AWS CloudShell para trabajar con AWS App Runner
<a name="api-cshell"></a>

AWS CloudShell es un shell preautenticado y basado en un navegador que puedes iniciar directamente desde. Consola de administración de AWS Puede ejecutar AWS CLI comandos en los AWS servicios (incluso AWS App Runner) utilizando el shell que prefiera (Bash o Z shell). PowerShell Y puede hacerlo sin necesidad de descargar o instalar herramientas de línea de comandos.

Los [AWS CloudShell ejecutas desde la Consola de administración de AWS](https://docs.aws.amazon.com/cloudshell/latest/userguide/working-with-cloudshell.html#launch-options) consola y las AWS credenciales que usaste para iniciar sesión en la consola estarán disponibles automáticamente en una nueva sesión de shell. Esta autenticación previa de AWS CloudShell los usuarios permite omitir la configuración de las credenciales al interactuar con AWS servicios como App Runner que utilizan la AWS CLI versión 2 (preinstalada en el entorno informático del shell).

**Topics**
+ [Obtener permisos de IAM para AWS CloudShell](#api-cshell.permissions)
+ [Interactúa con App Runner mediante AWS CloudShell](#api-cshell.call-apprunner)
+ [Verificar el servicio App Runner mediante AWS CloudShell](#api-cshell.call-your-service)

## Obtener permisos de IAM para AWS CloudShell
<a name="api-cshell.permissions"></a>

Con los recursos de administración de acceso que proporcionan AWS Identity and Access Management, los administradores pueden conceder permisos a los usuarios de IAM para que puedan acceder a las funciones del entorno AWS CloudShell y utilizarlas.

La forma más rápida de que un administrador conceda acceso a los usuarios es mediante una política AWS gestionada. Una [política administrada de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) es una política independiente creada y administrada por AWS. La siguiente política AWS administrada para se CloudShell puede adjuntar a las identidades de IAM:
+ `AWSCloudShellFullAccess`: Concede permiso de uso AWS CloudShell con acceso completo a todas las funciones.

 Si desea limitar el alcance de las acciones con las que puede realizar un usuario de IAM AWS CloudShell, puede crear una política personalizada que utilice la política `AWSCloudShellFullAccess` gestionada como plantilla. Para obtener más información sobre cómo limitar las acciones que están disponibles para los usuarios CloudShell, consulte [Administrar el AWS CloudShell acceso y el uso con políticas de IAM](https://docs.aws.amazon.com/cloudshell/latest/userguide/sec-auth-with-identities.html) en la Guía del *AWS CloudShell usuario*.

**nota**  
Tu identidad de IAM también requiere una política que otorgue permiso para realizar llamadas a App Runner. Para obtener más información, consulte [Cómo funciona App Runner con IAM](security_iam_service-with-iam.md).

## Interactúa con App Runner mediante AWS CloudShell
<a name="api-cshell.call-apprunner"></a>

Tras iniciarlo AWS CloudShell desde Consola de administración de AWS, podrás empezar a interactuar inmediatamente con App Runner mediante la interfaz de línea de comandos. 

En el siguiente ejemplo, recuperas información sobre uno de tus servicios de App Runner mediante la función AWS CLI in CloudShell.

**nota**  
 AWS CLI Al usarlo AWS CloudShell, no necesitas descargar ni instalar ningún recurso adicional. Además, dado que ya está autenticado en el intérprete de comandos, no tiene que configurar las credenciales antes de realizar llamadas.

**Example Recuperar la información del servicio de App Runner mediante AWS CloudShell**  

1. Desde Consola de administración de AWS, puede iniciar CloudShell seleccionando las siguientes opciones disponibles en la barra de navegación:
   +  Selecciona el CloudShell icono. 
   + Comience a escribir **cloudshell** en el cuadro de búsqueda y, a continuación, elija la **CloudShell**opción cuando aparezca en los resultados de la búsqueda.

1. Para ver todos los servicios actuales de App Runner de su AWS cuenta en la AWS región de la sesión de la consola, introduzca el siguiente comando en la línea de CloudShell comandos:

   ```
   $ aws apprunner list-services
   ```

   El resultado muestra un resumen de la información de sus servicios.

   ```
   {
     "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 obtener una descripción detallada de un servicio concreto de App Runner, ingresa el siguiente comando en la línea de CloudShell comandos, usando uno de los ARNs recuperados en el paso anterior:

   ```
   $ aws apprunner describe-service --service-arn arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa
   ```

   El resultado muestra una descripción detallada del servicio que especificó.

   ```
   {
     "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
       }
     }
   }
   ```

## Verificar el servicio App Runner mediante AWS CloudShell
<a name="api-cshell.call-your-service"></a>

Al [crear un servicio de App Runner](manage-create.md), App Runner crea un dominio predeterminado para el sitio web del servicio y lo muestra en la consola (o lo devuelve en el resultado de la llamada a la API). Puedes usarlo CloudShell para hacer llamadas a tu sitio web y comprobar que funciona correctamente.

Por ejemplo, después de crear un servicio de App Runner como se describe en[Cómo empezar a usar App Runner](getting-started.md), ejecute el siguiente comando en CloudShell:

```
$ curl https://qxuadi4qwp.us-east-2.awsapprunner.com/; echo
```

El resultado debe mostrar el contenido de la página esperado.

![\[Se muestra una ventana del navegador AWS CloudShell con un comando para mostrar el contenido de una página de servicio de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/api-cshell-curl.png)
