AWSToolkit for VS Code - Guía del usuario - Amazon

Página creada David Rodriguez
 
SEGUIR LEYENDO
AWSToolkit for VS Code - Guía del usuario - Amazon
AWSToolkit for VS Code
     Guía del usuario
AWSToolkit for VS Code - Guía del usuario - Amazon
AWSToolkit for VS Code Guía del usuario

AWSToolkit for VS Code: Guía del usuario
Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

Las marcas comerciales y la imagen comercial de Amazon no se pueden utilizar en relación con ningún producto o
servicio que no sea de Amazon de ninguna manera que pueda causar confusión entre los clientes y que menosprecie
o desacredite a Amazon. Todas las demás marcas comerciales que no son propiedad de Amazon son propiedad de
sus respectivos propietarios, que pueden o no estar afiliados, conectados o patrocinados por Amazon.
AWSToolkit for VS Code Guía del usuario

Table of Contents
  AWS Toolkit for Visual Studio Code ...................................................................................................... 1
       ¿Qué es AWS Toolkit for Visual Studio Code? ................................................................................ 1
       Información relacionada ............................................................................................................... 1
  Configuración ..................................................................................................................................... 2
       Instalación del Toolkit for VS Code ............................................................................................... 2
             Prerequisites ...................................................................................................................... 2
             Instalación del Toolkit for VS Code ....................................................................................... 3
       Establecimiento de credenciales ................................................................................................... 4
             Uso deAWScredenciales admitidas ....................................................................................... 4
             Uso de un proceso de credenciales externo .......................................................................... 10
       Conexión a AWS ...................................................................................................................... 10
             Connect toAWSUso del Toolkit for VS Code ......................................................................... 10
             Uso de variosAWSCuentas de con el Toolkit ........................................................................ 13
       CHANDAWSRegiones de ........................................................................................................... 13
             Agregue una región a laAWSExplorador de .......................................................................... 14
             Ocultar una región en la listaAWSExplorador de .................................................................... 15
       Configuración de su cadena de herramientas ................................................................................ 16
             Configurar una cadena de herramientas para de.NET Core ..................................................... 16
             Configurar una cadena de herramientas para Node.js ............................................................. 17
             Configurar una cadena de herramientas para Python ............................................................. 17
             Configurar una cadena de herramientas para Java ................................................................ 17
             Configurar una cadena de herramientas para Go ................................................................... 17
             Uso de su cadena de herramientas ..................................................................................... 18
  Explorador del Toolkit for VS Code ..................................................................................................... 19
       Componentes fundamentales de la interfaz de usuario ................................................................... 19
             LaAWSExplorador de ........................................................................................................ 19
             LaAWS CDKExplorador de ................................................................................................. 20
       Ubicaciones de los comandos .................................................................................................... 20
             Paleta de comandos de Visual Studio Code .......................................................................... 20
             AWSExplorador deMenú .................................................................................................... 22
  Trabajar con los servicios de AWS ...................................................................................................... 23
       Características experimentales .................................................................................................... 23
       AWSExplorador de .................................................................................................................... 23
             Amazon API Gateway ....................................................................................................... 25
             AWS App Runner ............................................................................................................. 25
             Pilas de AWS CloudFormation ............................................................................................ 31
             Amazon CloudWatch Logs ................................................................................................. 32
             Amazon EventBridge ......................................................................................................... 34
             Funciones AWS Lambda .................................................................................................... 37
             Amazon S3 ...................................................................................................................... 43
             AWS Systems Manager ..................................................................................................... 47
             AWS Step Functions ......................................................................................................... 51
             Recursos ......................................................................................................................... 58
       Amazon ECS ........................................................................................................................... 61
             Uso de IntelliSense para archivos de definición de tareas ....................................................... 62
       AWS CDKExplorador de ............................................................................................................ 62
             Aplicaciones de AWS CDK ................................................................................................. 63
       AWS Serverless Application ....................................................................................................... 65
             Supuestos y requisitos previos ............................................................................................ 65
             Permisos de IAM para aplicaciones sin servidor .................................................................... 66
             Creación de una nueva aplicación sin servidor (local) ............................................................. 66
             Apertura de una aplicación sin servidor (local) ....................................................................... 67
             Ejecución y depuración de una aplicación sin servidor desde una plantilla (local) ......................... 68
             Implementar una aplicación sin servidor en elAWSCloud ......................................................... 69

                                                                        iii
AWSToolkit for VS Code Guía del usuario

               Eliminación de una aplicación sin servidor de laAWSCloud ...................................................... 70
               Ejecución y depuración de funciones Lambda directamente desde el código .............................. 71
               Ejecución y depuración de recursos locales de Amazon API Gateway ....................................... 73
               Opciones de configuración para depurar aplicaciones sin servidor ............................................ 75
               Solución de problemas ...................................................................................................... 80
Seguridad ........................................................................................................................................ 83
       Protección de datos .................................................................................................................. 83
       Identity and Access Management ................................................................................................ 84
       Registro y monitorización ........................................................................................................... 84
       Validación de la conformidad ...................................................................................................... 85
       Resiliencia ............................................................................................................................... 85
       Seguridad de la infraestructura ................................................................................................... 86
       Configuración y análisis de vulnerabilidades ................................................................................. 86
Historial de documentos ..................................................................................................................... 87
.................................................................................................................................................. lxxxix

                                                                        iv
AWSToolkit for VS Code Guía del usuario
                             ¿Qué es AWS Toolkit for Visual Studio Code?

AWS Toolkit for Visual Studio Code
    Esta es la guía del usuario paraAWSToolkit for VS Code. Si está buscando AWS Toolkit for Visual Studio,
    consulte la Guía del usuario de AWS Toolkit for Visual Studio.

¿Qué es AWS Toolkit for Visual Studio Code?
    El Toolkit for VS Code es una extensión de código abierto para el editor de Visual Studio Code (VS Code).
    Esta extensión facilita a los desarrolladores el desarrollo, la depuración local y la implementación de
    aplicaciones sin servidor que utilicen Amazon Web Services (AWS).

    Topics

    • Configuración del AWS Toolkit for Visual Studio Code (p. 2)
    • Navegación por el AWS Toolkit for Visual Studio Code (p. 19)
    • Trabajar con los servicios de AWS (p. 23)

Información relacionada
    Consulte los siguientes recursos para obtener acceso al código fuente de este conjunto de herramientas o
    para ver los problemas abiertos en ese momento.

    • Código fuente
    • Identificador de problemas

    Para obtener más información acerca del editor de código de Visual Studio, visitehttps://
    code.visualstudio.com/..

                                                   1
AWSToolkit for VS Code Guía del usuario
                                  Instalación del Toolkit for VS Code

Configuración del AWS Toolkit for
Visual Studio Code
     Esta sección te ayuda a configurar el AWS Toolkit for Visual Studio Code. Proporciona información sobre
     cómo instalar y configurar el kit de herramientas, configurar tus credenciales y conectarte aAWS.

     Temas
      • Instalación de AWS Toolkit for Visual Studio Code (p. 2)
      • Establecimiento de credenciales para elAWS Toolkit for Visual Studio Code (p. 4)
      • Conexión a AWS través del AWS Toolkit for Visual Studio Code (p. 10)
      • CHANDAWSRegiones de (p. 13)
      • Configuración de su cadena de herramientas (p. 16)

Instalación de AWS Toolkit for Visual Studio Code
     En esta sección se describe cómo instalar el AWS Toolkit for Visual Studio Code.

     Prerequisites
     Required
     Para poder instalar Toolkit for VS Code, debe contar con lo siguiente:

     • Una cuenta de Amazon Web ServicesPara obtener unAWSAcceda aAWSPágina de inicio de.
       SeleccionarCreación de unAWSCuenta, o bienInscripciones(si ya ha visitado el sitio anteriormente).
       Registrarse le permite usar todos los servicios ofrecidos por AWS.
     • Un sistema operativo compatible— El Toolkit for VS Code es compatible con Windows, Linux y macOS.
     • VS Code versión 1.42.0 o posterior— Intentamos mantener el Toolkit for VS Code actualizado con la
       versión predeterminada disponible enPágina de descarga VS Code.

     Optional
     Para poder utilizar algunas características del Toolkit for VS Code, debe contar con lo siguiente:

     • Desarrollo de código: SDK pertinente para el lenguaje que desea usar. Puede realizar la descarga en los
       siguientes enlaces o usar su administrador de paquetes favorito:
       • SDK para .NET: https://dotnet.microsoft.com/download
       • SDK para Node.js: https://nodejs.org/en/download
       • SDK para Python: https://www.python.org/downloads
       • SDK de Java:http://aws.amazon.com/corretto/
       • SDK de Go:https://golang.org/doc/install
     • AWS SAMCLI— Este es unAWSHerramienta de la CLI de que facilita el desarrollo, las pruebas y el
       análisis locales de las aplicaciones sin servidor. Esto no es necesario para instalar el conjunto de
       herramientas. Sin embargo, le recomendamos que lo instale (así como Docker, que se describe a
       continuación) porque es necesario para cualquier funcionalidad de AWS Serverless Application Model
       (AWS SAM), como Creación de una nueva aplicación sin servidor (local) (p. 66).

                                                     2
AWSToolkit for VS Code Guía del usuario
                                  Instalación del Toolkit for VS Code

     Para obtener más información, consulte el artículo sobre instalación de la CLI de AWS SAM en la guía
     para desarrolladores de AWS Serverless Application Model.
• Docker— ElAWS SAMLa CLI de requiere esta plataforma de contenedores de software de código
  abierto. Para obtener más información e instrucciones e descarga, consulte Docker.
• Administrador de paquetes— Un gestor de paquetes para que pueda descargar y compartir el código de
  la aplicación.
     • .NET: NuGet
     • Node.js:npm
     • Python:pip
     • Java: GradleorMaven

Instalación del Toolkit for VS Code
1.     Inicie el editor de código VS.
2.     En el navegadorBarra de actividadesEn el lado del editor de VS Code (Code), elija la
       opciónExtensionesIcono . Se abrirá el cuadroExtensiones, que permite acceder a VS Code
       Marketplace.

3.     En el cuadro de búsqueda de Extensions (Extensiones), busque AWS Toolkit. Elija la entrada para ver
       la información detallada en el panel derecho.
4.     En el panel derecho, elija Install (Instalar).
5.     Una vez instalado, si se le pide que reinicie el editor, elija Reload Required (Volver a cargar
       obligatoriamente) para finalizar la instalación.

Después de instalar el Toolkit for VS Code, debe configurar sucredenciales (p. 4)para permitirle
acceder a suAWSdesde dentro de VS Code.

                                                        3
AWSToolkit for VS Code Guía del usuario
                                 Establecimiento de credenciales

Establecimiento de credenciales para elAWS
Toolkit for Visual Studio Code
    En esta sección se muestran los tipos de credenciales que puede utilizar con elAWSToolkit for VS Code.
    Ofrece información acerca de cómo obtener y configurar esas credenciales.

    Puede obtener credenciales a través deAWSy proporcionarlos al kit de herramientas mediante archivos de
    configuración. También puede obtener credenciales a través de un proceso de credenciales externo que
    no es compatible directamente conAWS.

    Temas
     • Uso deAWScredenciales admitidas (p. 4)
     • Uso de un proceso de credenciales externo (p. 10)

    Uso deAWScredenciales admitidas
    AWSse pueden proporcionar a laAWSToolkit for VS Code mediante el uso de suCompartidoAWSarchivo
    configo suCompartidoAWSarchivo de credenciales. Los métodos para utilizar estos archivos son los
    mismos que los de laAWS CLI. Para obtener información general acerca de cómo utilizar estos archivos,
    consulteArchivos de configuración y credencialesen laAWS Command Line InterfaceGuía del usuario de.

    Temas
     • ObtenciónAWSclaves de acceso (p. 4)
     • Configurar suAWScredenciales (p. 5)
     • Uso de credenciales de AWS SSO (p. 8)

    ObtenciónAWSclaves de acceso
    Para acceder a Amazon Web Services (AWS) con elAWS Toolkit for Visual Studio Code, debe configurar
    el conjunto de herramientas conAWSCredenciales de cuenta de Para hacerlo con unas credenciales
    soportadas por AWS, antes debe obtener las claves de acceso de AWS adecuadas.

    Para obtener más información acerca de los usuarios y de las credenciales, que queda fuera del alcance
    de esta guía, consulte los siguientes recursos:

    • AWSCredenciales de seguridad deen laReferencia general de Amazon Web Services
    • Introducción a la administración de identidades: Usuarios deen laIAM User Guide

    ¿Qué son losAWSclaves de acceso
    Las claves de acceso son las credenciales que le identifican en AWS y le permiten acceder
    programáticamente a los servicios y recursos de AWS. Las claves de acceso se pueden asociar a
    suAWSLa cuenta de (el «usuario raíz» de la cuenta de o con los usuarios que cree conAWS Identity and
    Access Management(IAM).
        Warning

        Como el usuario raíz es básicamente un administrador con acceso total a los servicios y recursos,
        le recomendamos crear primero un usuario de IAM con sólo los permisos requeridos para realizar

                                                  4
AWSToolkit for VS Code Guía del usuario
                              Uso deAWScredenciales admitidas

     las tareas necesarias. A continuación, para sus credenciales, puede utilizar una clave de acceso
     que esté asociada con ese usuario. Para obtener más información, consulte .Crear un usuario de
     IAM en suAWSCuentaen laIAM User Guide.

Una clave de acceso se compone de un ID de clave de acceso, que es análogo a un nombre de usuario,
y una clave de acceso secreta, que es análoga a una contraseña. Esta clave de acceso se usa para
firmar programáticamente las solicitudes que haga a AWS. Si no tiene claves de acceso, puede crearlas
utilizando la AWS Management Console. Le recomendamos utilizar claves de acceso para un usuario de
IAM en lugar de las claves de su usuario raíz de la cuenta de.
     Note

     Para crear claves de acceso, debe tener permisos para realizar las acciones de IAM requeridas.
     Para obtener más información, consulteConceder permisos de usuario de IAM para administrar la
     política de contraseñas y las credencialesen laIAM User Guide.

Obtenga suAWSclaves de acceso
1.   Abra la consola de IAM en https://console.aws.amazon.com/iam/.
2.   En el menú de navegación, elija Users (Usuarios).
3.   Seleccione su nombre de usuario de IAM (no la casilla de verificación) para ver los detalles.
4.   En la pestaña Security credentials (Credenciales de seguridad), elija Create access key (Crear clave
     de acceso).
5.   Para ver la nueva clave de acceso, elija Show (Mostrar). Las credenciales serán similares a las
     siguientes:

     • ID de clave de acceso: AKIAIOSFODNN7EXAMPLE
     • Clave de acceso secreta: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
6.   Para descargar el par de claves, elija Download .csv file (Descargar archivo .csv). Almacene las claves
     en un lugar seguro.
         Important

         • Mantenga las claves en secreto para proteger su cuenta de AWS y no las envíe nunca por
           correo electrónico. No las comparta fuera de su organización, aunque reciba una petición
           que parezca provenir de AWS o Amazon.com. Nadie que represente legítimamente a
           Amazon le pedirá nunca su clave secreta.
         • Si pierde la clave secreta, no podrá recuperarla. En su lugar, por motivos de seguridad,
           debe crear un nuevo par de claves y eliminar el anterior.

Una vez que haya obtenido suAWS, puede usar las claves de accesoAWSToolkit for VS Code de para
almacenarlos en suAWSo su archivo de configuración compartidoAWSarchivo de credenciales. Para saber
cómo hacerlo, consulte Adición de suAWSclaves de acceso a su entorno (p. 6).

Configurar suAWScredenciales
Para acceder a Amazon Web Services (AWS) con elAWS Toolkit for Visual Studio Code, debe hacer que
suAWSdisponibles para el kit de herramientas. Para utilizar las credenciales soportadas por AWS, siga
leyendo este tema. Para utilizar un proceso de credenciales externas, consulte Uso de un proceso de
credenciales externo (p. 10).
     Note

     Algunas características del Toolkit for VS Code, como la creación de una aplicación sin servidor,
     no requierenAWSCredenciales de .

                                                5
AWSToolkit for VS Code Guía del usuario
                             Uso deAWScredenciales admitidas

Obtenga suAWSclaves de acceso
Si aún no tiene claves de acceso de AWS adecuadas para guardarlas en su archivo de configuración
compartido de AWS o en su archivo de credenciales compartido de AWS, debe obtenerlas ahora.

Para ello, consulte ObtenciónAWSclaves de acceso (p. 4).

Acerca de los compartidosAWSfiles
El archivo de configuración compartido de AWS y el archivo de credenciales compartido de AWS se
pueden utilizar para almacenar la información de configuración y credenciales para AWS. De forma
predeterminada, estos archivos se encuentran en el directorio .aws dentro de su directorio principal y sus
nombres son config y credentials, respectivamente. Para obtener más información, consulte¿Dónde
se almacenan las opciones de configuración?en laAWS Command Line InterfaceGuía del usuario de.

El Toolkit for VS Code localiza y usaAWSclaves de acceso a través de suAWSy su archivo de
configuración compartidoAWSarchivo de credenciales. Este es el método que se utiliza en la AWS CLI y
los AWS SDK. Las claves de acceso que se especifican en el Toolkit for VS Code se guardan en uno de
estos archivos.

Estos archivos compartidos pueden contener las credenciales de más de una cuenta de AWS,
almacenadas como perfiles. Puede ser útil tener varias cuentas para proporcionar a los desarrolladores y
los administradores recursos independientes para el desarrollo y para el lanzamiento y la publicación, por
ejemplo.

Adición de suAWSclaves de acceso a su entorno
Si ya ha configurado suAWS(por ejemplo, mediante el uso de la herramientaAWS CLI), el Toolkit for
VS Code detectará automáticamente esas credenciales y las pondrá a disposición del conjunto de
herramientas. Si aún no ha configurado suAWS, o si desea incluirAWSPuede hacerlo a través del Toolkit
for VS Code, como se muestra aquí.
     Note

     Como alternativa a estos procedimientos, puede utilizar el comando aws configure de la AWS
     CLI para añadir unas credenciales de AWS al entorno. También puede utilizaraws configurePara
     establecer el valor predeterminadoAWSRegión, que es necesaria para ciertas operaciones como
     crear una aplicación sin servidor.

Crear el archivo compartidoAWSarchivo de credenciales

• Si ya tiene un archivo de credenciales compartido de AWS, puede ir directamente al siguiente
  procedimiento (p. 7).
• Si ya tiene unAWS Configurary desea utilizarlo, puede ir directamente a lasiguiente
  procedimiento (p. 7).
• Si solo tienes unAWS Configurarpero no desea utilizarlo, primero debe crear unaAWSmediante
  técnicas que son normales para el sistema operativo. A continuación, puede pasar al siguiente
  procedimiento (p. 7).

Siga estos pasos para crear el archivo de credenciales compartido de AWS.

1.   Abra el código VS.
2.   Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y
     seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso
     directo:

                                               6
AWSToolkit for VS Code Guía del usuario
                              Uso deAWScredenciales admitidas

     • Pulse Windows y Linux: pulseCtrl+Mayús+P.
     • macOS: PulseMayús+Comando+P.
3.   SearchAWSy elijaAWS: Crear perfil de credenciales.

4.   Especifique un nombre para el perfil inicial.

5.   Escriba el ID de clave de acceso para las credenciales. Si no tiene un ID de clave de acceso, consulte
     ObtenciónAWSclaves de acceso (p. 4).

6.   Especifique la clave de acceso secreta para las credenciales. Si no tiene una clave de acceso secreta,
     consulte ObtenciónAWSclaves de acceso (p. 4).

Después de completar este procedimiento, puede comprobar el archivo de credenciales compartido de
AWS; para ello, ábralo directamente o lleve a cabo los tres primeros pasos del siguiente procedimiento (sin
hacer ninguna actualización).

Actualizar uno de sus archivos compartidos

Siga estos pasos para añadir un nuevo perfil a un archivo de configuración compartido de AWS o a un
archivo de credenciales compartido de AWS. También puede actualizar un perfil existente.

1.   Abrir código VS.
2.   Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y
     seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso
     directo:

     • Pulse Windows y Linux: pulseCtrl+Mayús+P.
     • macOS: PulseMayús+Comando+P.
3.   SearchAWSy elijaAWS: Crear perfil de credenciales.

                                                 7
AWSToolkit for VS Code Guía del usuario
                             Uso deAWScredenciales admitidas

4.   Cuando uno o ambos archivos compartidos se abra en el editor de VS Code, agregue o actualice un
     perfil.
5.   Cuando haya terminado de actualizar el archivo, guárdelo.

Agregar perfiles de credenciales adicionales
Puede añadir perfiles y credenciales adicionales. Para ello, abra el cuadro de diálogoPaleta de comandos
dely elijaAWS: Crear perfil de credenciales. Esto abrirá el archivo de credenciales En esta página, puede
agregar un nuevo perfil debajo de su primer perfil, como en el siguiente ejemplo:

# Amazon Web Services Credentials File used by AWS CLI, SDKs, and tools
# This file was created by the AWS Toolkit for Visual Studio Code extension.
#
# Your AWS credentials are represented by access keys associated with IAM users.
# For information about how to create and manage AWS access keys for a user, see:
# https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html
#
# This credential file can store multiple access keys by placing each one in a
# named "profile". For information about how to change the access keys in a
# profile or to add a new profile with a different access key, see:
# https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html
#
[Profile1_Name]
# The access key and secret key pair identify your account and grant access to AWS.
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
# Treat your secret key like a password. Never share your secret key with anyone. Do
# not post it in online forums, or store it in a source control system. If your secret
# key is ever disclosed, immediately use IAM to delete the access key and secret key
# and create a new key pair. Then, update this file with the replacement key details.
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
[Profile2_Name]
aws_access_key_id = AKIAI44QH8DHBEXAMPLE
aws_secret_access_key = je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY

Uso de credenciales de AWS SSO
Para conectar conAWS Single Sign-On(AWS SSO), debe cumplir los siguientes requisitos previos:

1. HabilitarAWS SSO— Esto incluye elegir el origen de su identidad y configurarAWS SSOAcceso a
   laAWScuentas. Para obtener más información, consulteIntroducciónen laAWS Single Sign-OnGuía del
   usuario de.
2. Adición de unAWS SSOPerfil de— ConAWS SSO, defina un perfil con nombre en el archivo de
   credenciales o la configuración que utiliza para recuperar credenciales temporales para suAWSaccount.

                                              8
AWSToolkit for VS Code Guía del usuario
                              Uso deAWScredenciales admitidas

     La definición de perfil especifica la propiedadAWS SSO portal de usuariosasí como elAWSLa cuenta y
     el rol de IAM asociado al usuario que solicita acceso.

Para agregarAWS SSOPerfil de
El siguiente procedimiento muestra cómo añadir unaAWS SSOa su perfilcredentialsorconfigfile.

Agregar unAWS SSOa su archivo de credenciales en VS Code

1.    Abra el código VS.
2.    Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y
      seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso
      directo:

      • Pulse Windows y Linux: pulseCtrl+Mayús+P.
      • macOS: PulseMayús+Comando+P.
3.    SearchAWSy elijaAWS: Crear perfil de credenciales. Esto abrirá el archivo de credenciales
4.    En elcredentialsorconfigarchivo, en[default], agregue una plantilla para unAWS SSOPerfil
      de. A continuación se muestra un perfil de ejemplo:

      ... Named profile in credentials file ...

      [profile sso-user-1]
      sso_start_url = https://example.com/start
      sso_region = us-east-2
      sso_account_id = 123456789011
      sso_role_name = readOnly
      region = us-west-2

          Important

          No utilice la palabraPerfil deCuando cree una entrada en el archivo de credenciales Esto
          se debe a que el archivo de credenciales usa un formato de denominación diferente que el
          archivo de configuración. Incluir la palabra de prefijoprofileSolo cuando configure un perfil
          con nombre en el archivo de configuración.

Cuando asigne valores para su perfil, tenga en cuenta lo siguiente:

• sso_start_url: la URL que apunta a laAWS SSOportal de usuarios
• sso_region— ElAWSRegión que contiene suAWS SSOhost de portal Esto puede ser diferente de
  laAWSRegión especificada más adelante en el valor predeterminadoregionParámetro de.
• sso_account_id— ElAWSEl ID de la cuenta de que contiene el rol de IAM con el permiso que desea
  conceder a esteAWS SSOusuario.
• sso_role_name— El nombre del rol de IAM que define los permisos que tiene el usuario cuando utiliza
  este perfil para obtener credenciales a través deAWS SSO.
• region— El valor predeterminadoAWSRegión que estaAWS SSOel usuario iniciará sesión.

Inicie sesión conAWS SSO

Al iniciar sesión con unAWS SSO, el navegador predeterminado se inicia en el portal especificado. Debe
verificar suAWS SSOantes de que pueda acceder a suAWSrecursos en VS Code. Tenga en cuenta que
si sus credenciales caducan, tendrá que repetir el proceso de conexión para obtener nuevas credenciales
temporales.

                                                9
AWSToolkit for VS Code Guía del usuario
                                   Uso de un proceso de credenciales externo

    Uso de un proceso de credenciales externo
    Si tiene un proceso para generar o buscar credenciales que no es directamente compatible
    con laAWS, puede configurar elAWSToolkit for VS Code de use ese proceso en lugar de
    cualquieralmacenadoAWScredenciales (p. 4).

    El método para especificar un proceso de credenciales externo es el mismo que para elAWS CLI, y
    consiste en agregar uncredential_processdefinición a suCompartidoAWSarchivo config. Para obtener
    información detallada acerca de cómo hacerlo, consulteObtención de credenciales con un proceso
    externoen laAWS Command Line InterfaceGuía del usuario de.

Conexión a AWS través del AWS Toolkit for Visual
Studio Code
    Para interactuar con Amazon Web Services (AWS) a través delAWS Toolkit for Visual Studio CodeDebe
    establecer una conexión conAWS.

    Connect toAWSUso del Toolkit for VS Code
    1.   Abra el código VS.
    2.   Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y
         seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso
         directo:

         • Pulse Windows y Linux:Ctrl+Mayús+P.
         • macOS: PulseMayús+Comando+P.
    3.   Search forAWSy elijaAWS: Connect toAWS.

    4.   Elija un perfil de la lista.

         Si no tiene configurado un perfil de credenciales, se le pedirá que configure uno. Busque una ventana
         emergente en la esquina inferior derecha del editor. Elija Yes (Sí) y, a continuación, siga el asistente

                                                      10
AWSToolkit for VS Code Guía del usuario
                          Connect toAWSUso del Toolkit for VS Code

     de configuración para introducir un nombre de perfil, el ID de clave de acceso y la clave de acceso
     secreta. Para obtener información, consulte Configurar suAWScredenciales (p. 5).
         Note

         Si desea proporcionar un proceso de credenciales externas en lugar de utilizar credenciales
         soportadas por AWS, elija No (No) y consulte Uso de un proceso de credenciales
         externo (p. 10) en su lugar.

5.   Abra el iconoAWS: Explorador deBarra lateral, que llamamosAWSExplorador dePara comprobar la
     conexión. Verá una lista deAWSRegiones (si tieneha hecho visible cualquier Regiones (p. 14)en
     laAWSExplorador de) o un mensaje para agregar Regiones a laAWSExplorador de.

     Antesagregar Regiones (p. 13)a laAWSExplorador deVerá lo siguiente.

                                               11
AWSToolkit for VS Code Guía del usuario
                    Connect toAWSUso del Toolkit for VS Code

Después de agregar Regiones a laAWSExplorador deVerá algo parecido a lo siguiente.

                                       12
AWSToolkit for VS Code Guía del usuario
                             Uso de variosAWSCuentas de con el Toolkit

   Uso de variosAWSCuentas de con el Toolkit
   Es posible que tenga variosAWSCuentas de a las que desee acceder desde el Toolkit for VS Code.
   Puede ser útil tener varias cuentas para proporcionar a los desarrolladores y los administradores recursos
   independientes para el desarrollo y para el lanzamiento y la publicación, por ejemplo.

   Los conjuntos de credenciales de AWS se almacenan como perfiles en el archivo de configuración de AWS
   o en el archivo de credenciales compartidas de AWS. Para elegir otro conjunto de credenciales, siga los
   pasos del procedimiento anterior y elija un perfil diferente.

CHANDAWSRegiones de
   Al configurar sus credenciales, el iconoAWS Toolkit for Visual Studio Codeselecciona y muestra
   automáticamente el valor predeterminadoAWSRegión para esas credenciales en elAWSExplorador de. En
   este tema se describe cómo cambiar la lista de Regiones que se muestra en elAWSExplorador de.

                                                 13
AWSToolkit for VS Code Guía del usuario
                          Agregue una región a laAWSExplorador de

Agregue una región a laAWSExplorador de
1.   Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y
     seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso
     directo:

     • Para Windows y Linux: PulseCtrl+Mayús+P.
     • macOS: PulseMayús+Comando+P.
2.   Search forAWSy elijaAWS: Mostrar región en el Explorador.

3.   Elija la región que desea añadir aAWSExplorador de.

         Note

         La lista contiene sólo las regiones que están disponibles para agregar a la
         listaAWSExplorador de. Las regiones que ya ha agregado no aparecen en la lista.
4.   Compruebe que la región aparece ahora enAWSExplorador de.

                                              14
AWSToolkit for VS Code Guía del usuario
                         Ocultar una región en la listaAWSExplorador de

Ocultar una región en la listaAWSExplorador de
1.   Elija el iconoAWSen el iconoBarra de actividadespara abrirAWSExplorador de.
2.   Elija una de las regiones de la lista y abra su menú contextual.

                                                15
AWSToolkit for VS Code Guía del usuario
                             Configuración de su cadena de herramientas

    3.   SeleccionarHide Region from the Explorer.

Configuración de su cadena de herramientas
    LaAWS Toolkit for Visual Studio Codeadmite varios idiomas que puede usar para interactuar conAWS. En
    este tema describe cómo configurar la cadena de herramientas para cada uno de estos idiomas.

    Configurar una cadena de herramientas para de.NET
    Core
    1.   Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3).
    2.   Instalación delextensión C #. Esta extensión permite que VS Code depure las aplicaciones .NET Core.
    3.   Abra unAWS Serverless Application Model(AWS SAM), ocrear uno (p. 66).
    4.   Abra la carpeta que contienetemplate.yaml.

                                                 16
AWSToolkit for VS Code Guía del usuario
                      Configurar una cadena de herramientas para Node.js

Configurar una cadena de herramientas para Node.js
Al depurar un fuction TypeScript Lambda directamente desde el código fuente (la configuración de
lanzamiento»target«:»code«), el compilador TypeScript debe instalarse globalmente. Para obtener más
información acerca de la instalación de esta, consulteTypeScripten https://www.npmjs.com/.

1.   Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3).
2.   Abra unAWS SAMaplicación, ocrear uno (p. 66).
3.   Abra la carpeta que contienetemplate.yaml.

Configurar una cadena de herramientas para Python
1.   Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3).
2.   Instalación delExtensión de Python para Visual Studio Code. Esta extensión permite VS Code depurar
     aplicaciones Python.
3.   Abra unAWS SAMaplicación, ocrear uno (p. 66).
4.   Abra la carpeta que contienetemplate.yaml.
5.   Abra un terminal en la raíz de su aplicación y configurevirtualenvEjecutándosepython -m
     venv ./.venv.
          Note

          Solo tiene que configurarvirtualenvuna vez por sistema.
6.   ActivatevirtualenvEjecute una de las siguientes acciones:

     • Bash shell:./.venv/Scripts/activate
     • PowerShell:./.venv/Scripts/Activate.ps1

Configurar una cadena de herramientas para Java
1.   Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3).
2.   Instalación delExtensión Java y Java 11. Esta extensión permite que VS Code reconozca funciones
     Java.
3.   Instalación delextensión del depurador Java. Esta extensión permite a VS Code depurar aplicaciones
     Java.
4.   Abra unAWS SAMaplicación, ocrear uno (p. 66).
5.   Abra la carpeta que contienetemplate.yaml.

Configurar una cadena de herramientas para Go
1.   Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3).
2.   Go 1.14 o superior es necesario para depurar las funciones Go Lambda.
3.   Instalación delGo extensión.
          Note

          Se requiere la versión 0.25.0 o superior para depurar los tiempos de ejecución de Go1.15+.
4.   Instale las herramientas Go mediante elPaleta de comandos:

     a.   En la paleta de comandos, elijaGo: Install/Update Tools.

                                               17
AWSToolkit for VS Code Guía del usuario
                              Uso de su cadena de herramientas

     b.   En el conjunto de casillas de verificación, seleccionedlvygopls.
5.   Abra unAWS SAMaplicación, ocrear uno (p. 66).
6.   Abra la carpeta que contienetemplate.yaml.

Uso de su cadena de herramientas
Una vez que haya configurado su cadena de herramientas, puede usarlo paraEjecutar o
depurar (p. 68)elAWS SAMrevisiones de.

                                               18
AWSToolkit for VS Code Guía del usuario
                         Componentes fundamentales de la interfaz de usuario

Navegación por el AWS Toolkit for
Visual Studio Code
    En este tema se describe cómo navegar por el AWS Toolkit for Visual Studio Code. Asegúrese de instalar
    el conjunto de herramientas (p. 2) antes de leer este tema.

    Para obtener información general acerca de la interfaz de usuario (UI) de Visual Studio Code, consulte
    laDocumentación de IUPara VS Code.

Componentes fundamentales de la interfaz de
usuario
    Los siguientes son los componentes básicos de la interfaz de usuario delAWSToolkit for VS Code.

    LaAWSExplorador de
    • La imagen siguiente muestra los componentes básicos de la interfaz de usuario delAWSExplorador de.
      Consulte Uso deAWSServicios deAWSExplorador de (p. 23) para obtener más información sobre lo
      que puede hacer con él.

      LaAWSExplorador dese conoce más formalmente como elAWS: Explorador de la barra lateral.

                                                  19
AWSToolkit for VS Code Guía del usuario
                                   LaAWS CDKExplorador de

    LaAWS CDKExplorador de
    • La imagen siguiente muestra los componentes básicos de la interfaz de usuario delAWS CDKExplorador
      de. Consulte Uso delAWS CDKExplorador de (p. 62) para obtener más información sobre lo que
      puede hacer con él.

       Esta es una documentación preliminar para una característica en versión de vista previa. Está sujeta a
       cambios.

Ubicaciones de los comandos
    Encontrará los comandos del Toolkit for VS Code (Code) en varias ubicaciones.

    Paleta de comandos de Visual Studio Code
    La paleta de comandos de VS Code (Code) contiene todos los comandos que puede utilizar para trabajar
    conAWSServicios de . Para ver estos comandos, abra la paleta de comandos de VS Code (Code) en
    laVistaMenú de. O bien utilice los siguientes accesos directos:

    • Windows y Linux: pulseCtrl+Mayús+P.
    • macOS: pulseMayús+Comando+P.

                                                  20
AWSToolkit for VS Code Guía del usuario
                         Paleta de comandos de Visual Studio Code

A continuación, puede filtrar por»AWS«.

                                           21
AWSToolkit for VS Code Guía del usuario
                              AWSExplorador deMenú

AWSExplorador deMenú
LaAWSExplorador detiene unaMás accionesMenú que contiene los comandos que se usan más
habitualmente para trabajar conAWSServicios de .

                                          22
AWSToolkit for VS Code Guía del usuario
                                  Características experimentales

Trabajar con los servicios de AWS
    El AWS Toolkit for Visual Studio Code le permite ver y trabajar con varios servicios de AWS. Supone que
    ya hainstalado y configurado (p. 2)el Toolkit for VS Code de su sistema.

    Temas
     • Uso de características experimentales (p. 23)
     • Uso deAWSServicios deAWSExplorador de (p. 23)
     • Trabajar con Amazon Elastic Container Service (p. 61)
     • Uso delAWS CDKExplorador de (p. 62)
     • Trabajo con aplicaciones sin servidor (p. 65)

Uso de características experimentales
    Las funciones experimentales ofrecen acceso anticipado a las funciones delAWS Toolkit for Visual Studio
    Codeantes de ser liberados oficialmente.
         Warning

         Dado que las características experimentales se siguen probando y actualizando, pueden tener
         problemas de usabilidad. Además, las características experimentales pueden eliminarse delAWS
         Toolkit for Visual Studio Codesin previo aviso.

    Puede habilitar las funciones experimentales para específicasAWSservicios en elAWSConjunto de
    herramientasSección sobre de laConfiguraciónen el IDE de código VS.

    1.   Para editarAWSconfiguración en VS Code, elijaArchivo,Preferencias,Configuración.
    2.   En el navegadorConfiguraciónpanel, expandirExtensionesy eligeAWSConjunto de herramientas.
    3.   BajoAWS: Experiments, seleccione las casillas de verificación de las funciones experimentales a las
         que desea acceder antes de su lanzamiento. Si desea desactivar una función experimental, desactive
         la casilla de verificación correspondiente.

Uso deAWSServicios deAWSExplorador de
    LaAWSExplorador deOfrece una vista de algunas de lasAWSservicios con los que puede trabajar al
    utilizar elAWS Toolkit for Visual Studio Code. Vea una perspectiva general de laAWSExplorador deen
    lanavegación (p. 19)tema.

    En esta sección se ofrece información sobre cómo obtener acceso a laAWSExplorador deen VS Code.
    Supone que ya hainstalado y configurado (p. 2)el Toolkit for VS Code de su sistema.

    Algunos puntos importantes:

    • Si el conjunto de herramientas está instalado y configurado correctamente, debería ver elementos en
      laAWSExplorador de. Para ver lasAWSExplorador de, elige elAWSen elBarra de actividades.

                                                  23
AWSToolkit for VS Code Guía del usuario
                                    AWSExplorador de

  Por ejemplo:

• Para algunas características, se requieren permisos de AWS específicos. Por ejemplo, para ver
  elAWS Lambdafunciones deAWScuenta, las credenciales que configuró enEstablecimiento de
  credenciales (p. 4)debe incluir al menos permisos Lambda de solo lectura. Consulte los temas siguientes
  para obtener más información acerca de los permisos que necesita cada característica.
• Si quieres interactuar conAWSservicios que no son visibles inmediatamente en elAWSExplorador de,
  puedes ir aMás recursosy elige entre cientos de recursos que se pueden agregar a la interfaz.

  Por ejemplo, puede elegirAWS::CodeArtifact::Repositoryde la selección de los tipos de recursos
  disponibles. Después de agregar este tipo de recurso aMás recursos, puede ampliar la entrada para
  ver una lista de recursos que crean diferentes repositorios CodeArtifact con sus propias propiedades
  y atributos. Además, puede describir las propiedades y atributos de los recursos de las plantillas con
  formato JSON, que se pueden guardar para crear nuevos recursos en elAWSCloud.

Temas
 • Uso de Amazon API Gateway (p. 25)
 • Uso de AWS App Runner con AWS Toolkit for Visual Studio Code (p. 25)
 • Uso de pilas de AWS CloudFormation (p. 31)
 • Trabajo con CloudWatch Logs mediante elAWS Toolkit for Visual Studio Code (p. 32)
 • Trabajo con Amazon EventBridge (p. 34)
 • Trabajo con funciones de AWS Lambda (p. 37)
 • Trabajo con Amazon S3 (p. 43)
 • Trabajo con documentos de Systems Manager Automation (p. 47)
 • Uso de AWS Step Functions (p. 51)

                                              24
AWSToolkit for VS Code Guía del usuario
                                   Amazon API Gateway

 • Usar recursos de (p. 58)

Uso de Amazon API Gateway
Puede explorar y ejecutar recursos remotos de API Gateway en su conexiónAWScuenta utilizando elAWS
Toolkit for Visual Studio Code.
     Note

     Esta característica no admite la depuración.

Para explorar y ejecutar recursos remotos de API Gateway

1.   En el navegadorAWSExplorador de, eligeAPI Gatewaypara ampliar el menú. Se enumeran los
     recursos de API Gateway remota.
2.   Busque el recurso de API Gateway que desee invocar, abra su menú contextual (haga clic con el
     botón derecho) y, a continuación, elijaCómo invocar elAWS.
3.   En el formulario de parámetros, especifique los parámetros de invocación.
4.   Para ejecutar el recurso API Gateway remoto, elijaInvocación. Los resultados se muestran en la
     opciónSalida de código VSvista.

Uso de AWS App Runner con AWS Toolkit for Visual
Studio Code
AWS App Runnerproporciona una forma rápida, sencilla y rentable de implementar desde el código fuente
o una imagen de contenedor directamente en una aplicación web escalable y segura en elAWSCloud. Con
él, no es necesario aprender nuevas tecnologías, decidir qué servicio informático utilizar o saber cómo
aprovisionar y configurarAWSde AWS.

Puede usarAWS App Runnercrear y administrar servicios basados en unimagen de origenorCódigo fuente
de .. Si usas una imagen de origen, puedes elegir una imagen de contenedor pública o privada que se
almacena en un repositorio de imágenes. App Runner admite los siguientes proveedores de repositorios
de imágenes:

• Amazon Elastic Container Registry (Amazon ECR): Almacena imágenes privadas en su cuenta de AWS.
• Amazon Elastic Container Registry Público (Amazon ECR Público): Almacena imágenes legibles
  públicamente.

Si elige la opción de código fuente, puede desplegarla desde un repositorio de código fuente mantenido
por un proveedor de repositorios compatible. Actualmente, App Runner admiteGitHubcomo proveedor de
repositorio de código fuente.

Prerequisites
Para interactuar con App Runner mediante elAWS Toolkit for Visual Studio Coderequiere lo siguiente:

• Una cuenta de AWS.
• Una versión deAWS Toolkit for Visual Studio Codeque cuenta conAWS App Runner

Además de estos requisitos básicos, asegúrese de que todos los usuarios relevantes de IAM tengan
permisos para interactuar con el servicio App Runner. También necesitas obtener información específica

                                               25
AWSToolkit for VS Code Guía del usuario
                                     AWS App Runner

sobre tu fuente de servicio, como el URI de la imagen del contenedor o la conexión al repositorio de
GitHub. Necesitará esta información al crear el servicio de App Runner.

Configuración de permisos de IAM para App Runner
La forma más sencilla de conceder los permisos necesarios para App Runner es adjuntar un
existenteAWSpolítica gestionada a los pertinentesAWS Identity and Access Management(IAM),
específicamente un usuario o grupo. App Runner proporciona dos políticas administradas que puede
asociar a los usuarios de IAM:

• AWSAppRunnerFullAccess: Permite a los usuarios realizar todas las acciones de App Runner.
• AWSAppRunnerReadOnlyAccess: permite a los usuarios mostrar y ver detalles acerca de los recursos
  de App Runner.

Además, si elige un repositorio privado de Amazon Elastic Container Registry (Amazon ECR) como origen
de servicio, debe crear el siguiente rol de acceso para su servicio de App Runner:

• AWSAppRunnerServicePolicyForECRAccess: permite a App Runner acceder a imágenes de
  Amazon Elastic Container Registry (Amazon ECR) de su cuenta.

Puede crear este rol automáticamente al configurar la instancia de servicio con VS CodePaleta de
comandos del.
    Note

    LaFunción de servicio de AWS para ApprunnerLa función vinculada a un servicio permiteAWS
    App RunnerPara completar las siguientes tareas:

    • Envíe registros en los grupos de registros de Amazon CloudWatch Logs.
    • Cree reglas de Amazon CloudWatch Events para suscribirse a Amazon Elastic Container
      Registry (Amazon ECR).

    No necesita crear manualmente el rol vinculado al servicio . Al crear unAWS App Runneren
    laAWS Management Consoleo mediante operaciones de API a las que se llamaAWS Toolkit for
    Visual Studio Code,AWS App Runnercrea este rol vinculado al servicio por usted.

Para obtener más información, consulteAdministración de identidades y acceso para App Runneren laAWS
App RunnerGuía para desarrolladores.

Obtener fuentes de servicio para App Runner
Puede usarAWSApp Runner para implementar servicios desde una imagen o código fuente de origen.

Source image

    Si va a implementar desde una imagen de origen, puede obtener un enlace al repositorio de esa
    imagen desde un privado o público.AWSregistro de imágenes.

    • Registro privado de Amazon ECR: Copie el URI de un repositorio privado que utiliza la consola de
      Amazon ECR enhttps://console.aws.amazon.com/ecr/repositories.
    • Registro público de Amazon ECR: Copie el URI de un repositorio público que utiliza Amazon ECR
      Public Gallery enhttps://gallery.ecr.aws/.

        Note

        También puede obtener el URI de un repositorio privado de Amazon ECR directamente
        desdeAWSExplorador deen Toolkit for VS Code:

                                              26
AWSToolkit for VS Code Guía del usuario
                                    AWS App Runner

        • OpenAWSExplorador dey amplíe elECRnodo para ver la lista de repositorios para
          esoAWSRegión .
        • Haga clic con el botón derecho en un repositorio y elijaURI de copia del repositorioPara
          copiar el enlace al portapapeles.

    Especifica el URI del repositorio de imágenes al configurar la instancia de servicio con VS CodePaleta
    de comandos del

    Para obtener más información, consulteServicio App Runner basado en una imagen de origenen
    laAWS App RunnerGuía para desarrolladores.
Source code

    Para que el código fuente se implemente en unAWS App Runner, ese código debe almacenarse en
    un repositorio de Git mantenido por un proveedor de repositorios compatible. App Runner admite un
    proveedor de repositorios de código fuente: GitHub.

    Para obtener información sobre el modo de configurar un repositorio de GitHub, consulte
    laDocumentación de introducciónen GitHub.

    Para implementar tu código fuente en un servicio de App Runner desde un repositorio de GitHub, App
    Runner establece una conexión con GitHub. Si tu repositorio es privado (es decir, no es accesible
    públicamente en GitHub), debes proporcionar detalles de conexión a App Runner.
        Important

        Para crear conexiones de GitHub, debes usar la consola de App Runner (https://
        console.aws.amazon.com/apprunner) para crear una conexión que vincule GitHub aAWS.
        Puede seleccionar las conexiones que están disponibles en elConexiones de GitHubal
        configurar la instancia de servicio con VS CodePaleta de comandos del.
        Para obtener más información, consulteAdministración de conexiones de App Runen laAWS
        App RunnerGuía para desarrolladores.

    La instancia de servicio App Runner proporciona un tiempo de ejecución administrado que permite
    crear y ejecutar el código.AWS App Runneradmite actualmente los siguientes tiempos de ejecución:

    • Tiempo de ejecución administrado de Python
    • Tiempo de ejecución administrado de Node.js

    Como parte de la configuración del servicio, proporciona información sobre cómo se crea e inicia
    el servicio App Runner. Puede introducir esta información mediante elPaleta de comandos delo
    especificar un formato YAMLArchivo de configuración App Runner. Los valores de este archivo
    indican a App Runner cómo crear e iniciar el servicio y proporcionar contexto en tiempo de ejecución.
    Incluye la configuración de red y las variables de entorno relevantes. El archivo de configuración se
    llamaapprunner.yaml. Se añade automáticamente al directorio raíz del repositorio de la aplicación.

Pricing
Se le cobran los recursos informáticos y de memoria que utiliza la aplicación. Además, si automatiza
las implementaciones, también pagará una tarifa mensual fija por cada aplicación que cubre todas las
implementaciones automatizadas de ese mes. Si optas por implementar desde el código fuente, también
pagas una tarifa de compilación por el tiempo que tarda App Runner en crear un contenedor a partir de tu
código fuente.

Para obtener más información, consulte Precios de AWS App Runner.

                                              27
AWSToolkit for VS Code Guía del usuario
                                      AWS App Runner

Temas
 • Crear servicios de App Runner (p. 28)
 • Administración de servicios de App Run (p. 30)

Crear servicios de App Runner
Puede crear un servicio de App Runner en Toolkit for VS Code mediante elAWSExplorador dey VS
CodePaleta de comandos del. Después de elegir crear un servicio en un determinadoAWSRegión, pasos
numerados proporcionados por elPaleta de comandos delle guiará durante el proceso de configuración de
la instancia de servicio en la que se ejecuta la aplicación.

Antes de crear un servicio de App Runner, asegúrese de que ha completado elRequisitos previos
de (p. 25). Esto incluye proporcionar los permisos de IAM pertinentes y confirmar el repositorio de
origen específico que desea implementar.

Para crear un servicio de App Runner

1.   OpenAWSExplorador de, si aún no está abierto.
2.   Haga clic derecho enApp Runnernodo y eligeCrear un servicio.

     LaPaleta de comandos delmuestra.
3.   ParaSeleccione un tipo de ubicación de código fuente, eligeECRorRepositorio.

     Si eligeECR, especifica una imagen de contenedor en un repositorio mantenido por Amazon Elastic
     Container Registry. Si eligeRepositorio, especifica un repositorio de código fuente que mantiene un
     proveedor de repositorios compatible. Actualmente, App Runner admiteGitHubcomo proveedor de
     repositorio de código fuente.

Despliegue desde ECR

1.   ParaSeleccionar o introducir un repositorio de imágenes, elija o introduzca la URL del repositorio de
     imágenes que mantiene su registro privado de Amazon ECR o la Galería pública de Amazon ECR.
         Note

         Si especifica un repositorio de Amazon ECR Public Gallery, asegúrese de que las
         implementaciones automáticas estén desactivadas porque App Runner no admite
         implementaciones automáticas para una imagen en un repositorio público de ECR.
         Las implementaciones automáticas se desactivan de forma predeterminada y esto se indica
         cuando el icono de laPaleta de comandos delel encabezado presenta una línea diagonal a
         través de él. Si eligió activar las implementaciones automáticas, un mensaje le informa de
         que esta opción puede generar costes adicionales.
2.   Si el archivo dePaleta de comandos delStep informa de queNo se han encontrado etiquetas,
     debe retroceder un paso para seleccionar un repositorio que contenga una imagen de contenedor
     etiquetada.
3.   Si utiliza un registro privado de Amazon ECR, necesita el rol de acceso ECR,Función de acceso ECR
     de AppRunner, que permite a App Runner acceder a imágenes de Amazon Elastic Container Registry
     (Amazon ECR) de su cuenta. Elija el icono «+» en elPaleta de comandos delencabezado para crear
     automáticamente este rol. (No se requiere un rol de acceso si la imagen se almacena en Amazon ECR
     Public, donde las imágenes están disponibles públicamente).
4.   ParaPuerto, introduzca el puerto IP utilizado por el servicio (Puerto8000, por ejemplo).
5.   Paraconfigurar variables de entorno, puede especificar un archivo que contenga variables de entorno
     que se utilizan para personalizar el comportamiento de la instancia de servicio. O puede omitir este
     paso.

                                               28
También puede leer