AWSToolkit for VS CodeGuía del usuario

AWSToolkit for VS Code Guía del usuario

AWSToolkit for VS Code: Guía del usuarioCopyright © 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 oservicio que no sea de Amazon de ninguna manera que pueda causar confusión entre los clientes y que menosprecieo desacredite a Amazon. Todas las demás marcas comerciales que no son propiedad de Amazon son propiedad desus respectivos propietarios, que pueden o no estar afiliados, conectados o patrocinados por Amazon.

AWSToolkit for VS Code Guía del usuario

Table of ContentsAWS Toolkit for Visual Studio Code ..................................................................................................... 1

¿Qué es AWS Toolkit for Visual Studio Code ? ............................................................................... 1Información relacionada ............................................................................................................... 1

Configuración ..................................................................................................................................... 2Instalación del Toolkit for VS Code ............................................................................................... 2

Prerequisites ...................................................................................................................... 2Instalación del Toolkit for VS Code ....................................................................................... 3

Establecimiento de credenciales ................................................................................................... 4Uso deAWScredenciales admitidas ....................................................................................... 4Uso de un proceso de credenciales externo .......................................................................... 10

Conexión a AWS ...................................................................................................................... 10Connect toAWSUso del Toolkit for VS Code ......................................................................... 10Uso de variosAWSCuentas de con el Toolkit ........................................................................ 13

CHANDAWSRegiones de ........................................................................................................... 13Agregue una región a laAWSExplorador de .......................................................................... 14Ocultar una región en la listaAWSExplorador de .................................................................... 15

Configuración de su cadena de herramientas ................................................................................ 16Configurar una cadena de herramientas para de.NET Core ..................................................... 16Configurar una cadena de herramientas para Node.js ............................................................. 17Configurar una cadena de herramientas para Python ............................................................. 17Configurar una cadena de herramientas para Java ................................................................ 17Configurar una cadena de herramientas para Go ................................................................... 17Uso de su cadena de herramientas ..................................................................................... 18

Explorador del Toolkit for VS Code ..................................................................................................... 19Componentes fundamentales de la interfaz de usuario ................................................................... 19

LaAWSExplorador de ........................................................................................................ 19LaAWS CDKExplorador de ................................................................................................. 20

Ubicaciones de los comandos .................................................................................................... 20Paleta de comandos de Visual Studio Code .......................................................................... 20AWSExplorador deMenú .................................................................................................... 22

Trabajar con los servicios de AWS ...................................................................................................... 23AWSExplorador de .................................................................................................................... 23

Amazon API Gateway ....................................................................................................... 25AWS App Runner ............................................................................................................. 25Pilas de AWS CloudFormation ............................................................................................ 31Amazon CloudWatch Logs ................................................................................................. 32Amazon EventBridge ......................................................................................................... 35Funciones AWS Lambda .................................................................................................... 37Amazon S3 ...................................................................................................................... 43AWS Systems Manager ..................................................................................................... 47AWS Step Functions ......................................................................................................... 51

Amazon ECS ........................................................................................................................... 58Uso de IntelliSense para archivos de definición de tareas ....................................................... 58

AWS CDKExplorador de ............................................................................................................ 59Aplicaciones de AWS CDK ................................................................................................. 59

AWS Serverless Application ...................................................................................................... 62Requisitos previos ............................................................................................................. 62Permisos de IAM para aplicaciones sin servidor .................................................................... 63Creación de una nueva aplicación sin servidor (local) ............................................................. 63Abrir una aplicación sin servidor (local) ................................................................................ 64Ejecución y depuración de una aplicación sin servidor desde la plantilla (local) ........................... 64Implementar una aplicación sin servidor enAWSCloud ............................................................ 65Eliminar una aplicación sin servidor deAWSCloud .................................................................. 66Ejecutar y depurar funciones de Lambda directamente desde el código ..................................... 67

iii

AWSToolkit for VS Code Guía del usuario

Ejecución y depuración de recursos locales de Amazon API Gateway ....................................... 69Opciones de configuración para depurar aplicaciones sin servidor ............................................ 72Solución de problemas ...................................................................................................... 76

Seguridad ........................................................................................................................................ 79Protección de los datos ............................................................................................................. 79Identity and Access Management ................................................................................................ 80Registro y monitorización ........................................................................................................... 80Validación de la conformidad ...................................................................................................... 81Resiliencia ............................................................................................................................... 81Seguridad de la infraestructura ................................................................................................... 82Configuración y análisis de vulnerabilidades ................................................................................. 82

Historial de revisión ........................................................................................................................... 83................................................................................................................................................... lxxxv

iv

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

AWS Toolkit for Visual Studio CodeEsta 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 deaplicaciones 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 relacionadaConsulte los siguientes recursos para obtener acceso al código fuente de este conjunto de herramientas opara 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 usuarioInstalación del Toolkit for VS Code

Configuración del AWS Toolkit forVisual Studio Code

Esta sección te ayuda a configurar el AWS Toolkit for Visual Studio Code . Proporciona información sobrecó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 el AWS 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 CodeEn esta sección se describe cómo instalar el AWS Toolkit for Visual Studio Code .

PrerequisitesRequiredPara 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.

OptionalPara 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 lossiguientes 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 elanálisis locales de las aplicaciones sin servidor. Esto no es necesario para instalar el conjunto deherramientas. Sin embargo, le recomendamos que lo instale (así como Docker, que se describe acontinuació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. 63).

2

AWSToolkit for VS Code Guía del usuarioInstalació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íapara desarrolladores de AWS Serverless Application Model.

• Docker— ElAWS SAMLa CLI de requiere esta plataforma de contenedores de software de códigoabierto. 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 dela aplicación.• .NET: NuGet• Node.js:npm• Python:pip• Java: GradleorMaven

Instalación del Toolkit for VS Code1. 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 CodeMarketplace.

3. En el cuadro de búsqueda de Extensions (Extensiones), busque AWS Toolkit . Elija la entrada paraver 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 permitirleacceder a suAWSdesde dentro de VS Code.

3

AWSToolkit for VS Code Guía del usuarioEstablecimiento de credenciales

Establecimiento de credenciales para el AWSToolkit 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 deconfiguración. También puede obtener credenciales a través de un proceso de credenciales externo queno es compatible directamente conAWS.

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

Uso deAWScredenciales admitidasAWSse pueden proporcionar a laAWSToolkit for VS Code mediante el uso de suCompartidoAWSarchivoconfigo suCompartidoAWSarchivo de credenciales. Los métodos para utilizar estos archivos son losmismos 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 accesoPara acceder a Amazon Web Services (AWS) con el AWS Toolkit for Visual Studio Code , debe configurarel conjunto de herramientas conAWSCredenciales de cuenta de Para hacerlo con unas credencialessoportadas 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 alcancede 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 accederprogramáticamente a los servicios y recursos de AWS. Las claves de acceso se pueden asociar asuAWSLa cuenta de (el «usuario raíz» de la cuenta de o con los usuarios que cree conAWS Identity andAccess 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 usuarioUso deAWScredenciales admitidas

las tareas necesarias. A continuación, para sus credenciales, puede utilizar una clave de accesoque esté asociada con ese usuario. Para obtener más información, consulte .Crear un usuario deIAM 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 parafirmar programáticamente las solicitudes que haga a AWS. Si no tiene claves de acceso, puede crearlasutilizando la AWS Management Console. Le recomendamos utilizar claves de acceso para un usuario deIAM 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 lapolí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 clavesen un lugar seguro.

Important

• Mantenga las claves en secreto para proteger su cuenta de AWS y no las envíe nunca porcorreo electrónico. No las comparta fuera de su organización, aunque reciba una peticiónque parezca provenir de AWS o Amazon.com. Nadie que represente legítimamente aAmazon 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 paraalmacenarlos en suAWSo su archivo de configuración compartidoAWSarchivo de credenciales. Para sabercómo hacerlo, consulte Adición de suAWSclaves de acceso a su entorno (p. 6).

Configurar suAWScredencialesPara acceder a Amazon Web Services (AWS) con el AWS Toolkit for Visual Studio Code , debe hacerque 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 decredenciales 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 usuarioUso deAWScredenciales admitidas

Obtenga suAWSclaves de acceso

Si aún no tiene claves de acceso de AWS adecuadas para guardarlas en su archivo de configuracióncompartido 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 sepueden utilizar para almacenar la información de configuración y credenciales para AWS. De formapredeterminada, estos archivos se encuentran en el directorio .aws dentro de su directorio principal y susnombres son config y credentials, respectivamente. Para obtener más información, consulte¿Dóndese 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 deconfiguración compartidoAWSarchivo de credenciales. Este es el método que se utiliza en la AWS CLI ylos AWS SDK. Las claves de acceso que se especifican en el Toolkit for VS Code se guardan en uno deestos 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 ylos administradores recursos independientes para el desarrollo y para el lanzamiento y la publicación, porejemplo.

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 forVS Code detectará automáticamente esas credenciales y las pondrá a disposición del conjunto deherramientas. Si aún no ha configurado suAWS, o si desea incluirAWSPuede hacerlo a través del Toolkitfor VS Code, como se muestra aquí.

Note

Como alternativa a estos procedimientos, puede utilizar el comando aws configure de la AWSCLI para añadir unas credenciales de AWS al entorno. También puede utilizaraws configureParaestablecer el valor predeterminadoAWSRegión, que es necesaria para ciertas operaciones comocrear 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 siguienteprocedimiento (p. 7).

• Si ya tiene unAWS Configurary desea utilizarlo, puede ir directamente a lasiguienteprocedimiento (p. 7).

• Si solo tienes unAWS Configurarpero no desea utilizarlo, primero debe crear unaAWSmediantetécnicas que son normales para el sistema operativo. A continuación, puede pasar al siguienteprocedimiento (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 accesodirecto:

6

AWSToolkit for VS Code Guía del usuarioUso 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, consulteObtenció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 deAWS; para ello, ábralo directamente o lleve a cabo los tres primeros pasos del siguiente procedimiento (sinhacer 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 unarchivo 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 accesodirecto:

• 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 usuarioUso deAWScredenciales admitidas

4. Cuando uno o ambos archivos compartidos se abra en el editor de VS Code, agregue o actualice unperfil.

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 comandosdely elijaAWS: Crear perfil de credenciales. Esto abrirá el archivo de credenciales En esta página, puedeagregar 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 = AKIAI44QH8DHBEXAMPLEaws_secret_access_key = je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY

Uso de credenciales de AWS SSOPara 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 alaAWScuentas. Para obtener más información, consulteIntroducciónen laAWS Single Sign-OnGuía delusuario de.

2. Adición de unAWS SSOPerfil de— ConAWS SSO, defina un perfil con nombre en el archivo decredenciales o la configuración que utiliza para recuperar credenciales temporales para suAWSaccount.

8

AWSToolkit for VS Code Guía del usuarioUso deAWScredenciales admitidas

La definición de perfil especifica la propiedadAWS SSO portal de usuariosasí como elAWSLa cuenta yel 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 accesodirecto:

• 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 credenciales4. 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/startsso_region = us-east-2sso_account_id = 123456789011sso_role_name = readOnlyregion = us-west-2

Important

No utilice la palabraPerfil deCuando cree una entrada en el archivo de credenciales Estose debe a que el archivo de credenciales usa un formato de denominación diferente que elarchivo de configuración. Incluir la palabra de prefijoprofileSolo cuando configure un perfilcon 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. Debeverificar suAWS SSOantes de que pueda acceder a suAWSrecursos en VS Code. Tenga en cuenta quesi sus credenciales caducan, tendrá que repetir el proceso de conexión para obtener nuevas credencialestemporales.

9

AWSToolkit for VS Code Guía del usuarioUso de un proceso de credenciales externo

Uso de un proceso de credenciales externoSi tiene un proceso para generar o buscar credenciales que no es directamente compatiblecon laAWS, puede configurar elAWSToolkit for VS Code de use ese proceso en lugar decualquieralmacenadoAWScredenciales (p. 4).

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

Conexión a AWS través del AWS Toolkit for VisualStudio Code

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

Connect toAWSUso del Toolkit for VS Code1. 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 accesodirecto:

• 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 ventanaemergente 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 usuarioConnect 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 accesosecreta. Para obtener información, consulte Configurar suAWScredenciales (p. 5).

Note

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

5. Abra el iconoAWS: Explorador deBarra lateral, que llamamosAWSExplorador dePara comprobar laconexión. Verá una lista deAWSRegiones (si tieneha hecho visible cualquier Regiones (p. 14)enlaAWSExplorador 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 usuarioConnect 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 usuarioUso de variosAWSCuentas de con el Toolkit

Uso de variosAWSCuentas de con el ToolkitEs 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 recursosindependientes 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 AWSo en el archivo de credenciales compartidas de AWS. Para elegir otro conjunto de credenciales, siga lospasos del procedimiento anterior y elija un perfil diferente.

CHANDAWSRegiones deAl configurar sus credenciales, el icono AWS Toolkit for Visual Studio Code selecciona y muestraautomáticamente el valor predeterminadoAWSRegión para esas credenciales en elAWSExplorador de. Eneste tema se describe cómo cambiar la lista de Regiones que se muestra en elAWSExplorador de.

13

AWSToolkit for VS Code Guía del usuarioAgregue una región a laAWSExplorador de

Agregue una región a laAWSExplorador de1. 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 accesodirecto:

• 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 lalistaAWSExplorador 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 usuarioOcultar una región en la listaAWSExplorador de

Ocultar una región en la listaAWSExplorador de1. 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 usuarioConfiguración de su cadena de herramientas

3. SeleccionarHide Region from the Explorer.

Configuración de su cadena de herramientasLa AWS Toolkit for Visual Studio Code admite varios idiomas que puede usar para interactuar conAWS. Eneste tema describe cómo configurar la cadena de herramientas para cada uno de estos idiomas.

Configurar una cadena de herramientas para de.NETCore1. 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. 63).4. Abra la carpeta que contienetemplate.yaml.

16

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

Configurar una cadena de herramientas para Node.jsAl depurar un fuction TypeScript Lambda directamente desde el código fuente (la configuración delanzamiento»target«:»code«), el compilador TypeScript debe instalarse globalmente. Para obtener másinformació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. 63).3. Abra la carpeta que contienetemplate.yaml.

Configurar una cadena de herramientas para Python1. 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. 63).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 Java1. 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. 63).5. Abra la carpeta que contienetemplate.yaml.

Configurar una cadena de herramientas para Go1. 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 usuarioUso de su cadena de herramientas

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

Uso de su cadena de herramientasUna vez que haya configurado su cadena de herramientas, puede usarlo paraEjecutar odepurar (p. 64)elAWS SAMrevisiones de.

18

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

Navegación por el AWS Toolkit forVisual Studio Code

En este tema se describe cómo navegar por el AWS Toolkit for Visual Studio Code . Asegúrese de instalarel 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, consultelaDocumentación de IUPara VS Code.

Componentes fundamentales de la interfaz deusuario

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 deAWSEn elAWSExplorador de (p. 23) para obtener más información sobre lo quepuede hacer con él.

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

19

AWSToolkit for VS Code Guía del usuarioLaAWS 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. 59) para obtener más información sobre lo quepuede hacer con él.

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

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

Paleta de comandos de Visual Studio CodeLa paleta de comandos de VS Code (Code) contiene todos los comandos que puede utilizar para trabajarconAWSServicios de . Para ver estos comandos, abra la paleta de comandos de VS Code (Code) enlaVistaMenú 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 usuarioPaleta de comandos de Visual Studio Code

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

21

AWSToolkit for VS Code Guía del usuarioAWSExplorador deMenú

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

22

AWSToolkit for VS Code Guía del usuarioAWSExplorador de

Trabajar con los servicios de AWSEl AWS Toolkit for Visual Studio Code le permite ver y trabajar con varios servicios de AWS. Supone queya haInstalado y configurado (p. 2)el Toolkit for VS Code en su sistema.

Temas• Uso deAWSEn elAWSExplorador de (p. 23)• Trabajar con Amazon Elastic Container Service (p. 58)• Uso delAWS CDKExplorador de (p. 59)• Cómo trabajar con aplicaciones sin servidor (p. 62)

Uso deAWSEn elAWSExplorador deLaAWSExplorador deOfrece una perspectiva general deAWScon los que se puede trabajar cuando seutiliza el AWS Toolkit for Visual Studio Code . Consulte una perspectiva general deAWSExplorador deenlaNavegación (p. 19)Tema.

En esta sección se explica cómo obtener acceso a laAWSExplorador deen VS Code. Se supone que yahaInstalado y configurado (p. 2)el Toolkit for VS Code en su sistema.

Algunos puntos importantes:

• Si el conjunto de herramientas está instalado y configurado correctamente, debería aparecer elementosen la secciónAWSExplorador de. Para ver elAWSExplorador de, elija la opciónAWSicono en elBarra deactividades.

Por ejemplo:

23

AWSToolkit for VS Code Guía del usuarioAWSExplorador de

• Para algunas características, se requieren permisos de AWS específicos. Por ejemplo, para ver elAWSLambdaen elAWS, las credenciales que configuró enEstablecimiento de credenciales (p. 4)debeincluir al menos permisos de Lambda de solo lectura. Consulte los temas siguientes para obtener másinformación acerca de los permisos que necesita cada característica.

Temas• Trabajo con Amazon API Gateway (p. 25)• Uso de AWS App Runner con AWS Toolkit for Visual Studio Code (p. 25)• Uso deAWS CloudFormationpilas (p. 31)• Trabajar con CloudWatch Logs mediante la herramienta AWS Toolkit for Visual Studio Code (p. 32)• Trabajo con Amazon EventBridge (p. 35)• 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 usuarioAmazon API Gateway

Trabajo con Amazon API GatewayPuede examinar y ejecutar recursos remotos de API Gateway en suAWScon la cuentaAWS Toolkit forVisual Studio Code.

Note

Esta característica no admite la depuración de.

Para examinar y ejecutar recursos remotos de API Gateway

1. En el navegadorAWSExplorador de, elijaAPI Gatewaypara expandir el menú. Se enumeran losrecursos de API Gateway remota.

2. Busque el recurso de API Gateway al que desea invocar, abra su menú contextual (haga clic con elbotó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 elSalida

de código VSVista.

Uso de AWS App Runner con AWS Toolkit for VisualStudio CodeAWS App Runnerproporciona una forma rápida, sencilla y rentable de implementar desde el código fuenteo una imagen de contenedor directamente a una aplicación web escalable y segura en elAWSNubes. Alutilizarlo, no necesita aprender nuevas tecnologías, decidir qué servicio informático usar ni saber cómoaprovisionar y configurarAWSde AWS.

Puede usarAWS App Runnerpara crear y administrar servicios basados en unimagen de origenorCódigofuente de .. Si utiliza una imagen de origen, puede elegir una imagen de contenedor pública o privada quese almacena en un repositorio de imágenes. App Runner es compatible con los siguientes proveedores derepositorios de imágenes:

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

legibles públicamente.

Si elige la opción de código fuente, puede implementar desde un repositorio de código fuente mantenidopor un proveedor de repositorio compatible. Actualmente, App Runner admiteGitHubComo proveedor derepositorio de código fuente.

PrerequisitesPara interactuar con App Runner mediante el AWS Toolkit for Visual Studio Code Requiere lo siguiente:

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

Además de esos requisitos básicos, asegúrese de que todos los usuarios de IAM relevantes tenganpermisos para interactuar con el servicio App Runner. También necesita obtener información específicasobre su fuente de servicio, como el URI de la imagen del contenedor o la conexión al repositorio deGitHub. Necesitará esta información para crear el servicio de App Runner.

25

AWSToolkit for VS Code Guía del usuarioAWS App Runner

Configuración de permisos de IAM para App Runner

La forma más fácil de conceder los permisos necesarios para App Runner es adjuntar unAWSdirectivaadministrada a laAWS Identity and Access Management(IAM), específicamente un usuario o grupo. AppRunner ofrece 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 que los usuarios muestren y vean detalles acerca de los

recursos de App Runner.

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

• AWSAppRunnerServicePolicyForECRAccess: permite que App Runner acceda a imágenes deAmazon Elastic Container Registry (Amazon ECR) en tu cuenta de.

Puede crear este rol automáticamente al configurar su instancia de servicio con elPaleta de comandos del.

Note

LaAWSServiceRoleForApprunnerLa función vinculada a un servicio permiteAWS App RunnerParacompletar las tareas siguientes:

• Insertar 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 RunnerenlaAWS Management Consoleo mediante el uso de operaciones API que son llamadas porAWSToolkit for Visual Studio Code,AWS App RunnerDe esta forma, se encarga de crear este rolvinculado al servicio.

Para obtener más información, consulteGestión de identidades y accesos para App Runneren laAWS AppRunnerGuía para desarrolladores.

Obtención de fuentes de servicio para App Runner

Puede usarAWSApp Runner para implementar servicios desde una imagen fuente o código fuente.

Source image

Si está implementando desde una imagen de origen, puede obtener un vínculo al repositorio para esaimagen desde unAWSregistro de imágenes.

• Registro privado de Amazon ECR: Copie el URI de un repositorio privado que utilice la consola deAmazon ECR enhttps://console.aws.amazon.com/ecr/repositories.

• Registro público de Amazon ECR: Copie el URI de un repositorio público que utilice la Galeríapública de Amazon ECR enhttps://gallery.ecr.aws/.

Note

También puede obtener el URI de un repositorio privado de Amazon ECR directamentedesdeAWSExplorador deEn Toolkit for VS Code:

• OpenAWSExplorador dey expanda elECRpara ver la lista de repositorios paraeseAWSRegión .

26

AWSToolkit for VS Code Guía del usuarioAWS App Runner

• Haga clic derecho en un repositorio y elijaCopiar URI delPara copiar el enlace alportapapeles.

Especifique el URI para el repositorio de imágenes al configurar su instancia de servicio con elPaletade comandos del

Para obtener más información, consulteServicio App Runner basado en una imagen de origenenlaAWS 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 unrepositorio de Git que sea mantenido por un proveedor de repositorio compatible. App Runner admiteun proveedor de repositorio de código fuente: GitHub.

Para obtener más información sobre la configuración de un repositorio de GitHub, consultelaIntroducción a la documentaciónen GitHub.

Para implementar el código fuente en un servicio App Runner desde un repositorio de GitHub, AppRunner establece una conexión con GitHub. Si su repositorio es privado (es decir, no es accesiblepúblicamente en GitHub), debe proporcionar a App Runner detalles de conexión.

Important

Para crear conexiones de GitHub, debe 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 la pestañaConexiones GitHubalconfigurar su instancia de servicio con elPaleta de comandos del.Para obtener más información, consulteAdministración de conexiones de App RunnerenlaAWS App RunnerGuía para desarrolladores.

La instancia del servicio App Runner proporciona un tiempo de ejecución administrado que permitecompilar y ejecutar el código.AWS App Runneradmite actualmente los siguientes tiempos deejecució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 acerca de cómo el servicioApp Runner crea e inicia el servicio. Puede introducir esta información utilizando el botónPaleta decomandos delo especificar un formato YAMLArchivo de configuración de App Runner. Los valores deeste archivo indican a App Runner cómo crear e iniciar el servicio, y proporcionan contexto en tiempode ejecución. Esto incluye las variables de entorno y configuración de red relevantes. El archivo deconfiguración se llamaapprunner.yaml. Se agrega automáticamente al directorio raíz del repositoriode su aplicación.

PricingSe le cobrará por los recursos informáticos y de memoria que utiliza la aplicación. Además, si automatizalas implementaciones, también paga una cuota mensual establecida por cada aplicación que cubra todaslas implementaciones automatizadas de ese mes. Si optas por implementar desde el código fuente,también pagarás una tarifa de compilación por la cantidad de tiempo que tarda App Runner en crear uncontenedor 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 usuarioAWS App Runner

Temas• Creación de servicios App Runner (p. 28)• Administración de los servicios de App Runner (p. 30)

Creación de servicios App RunnerPuede crear un servicio App Runner en Toolkit for VS Code utilizando la herramientaAWSExploradordey VS CodePaleta de comandos del. Después de elegir crear un servicio en unAWSRegión, pasosnumerados proporcionados por elPaleta de comandos delle guiará por el proceso de configuración de lainstancia de servicio en la que se ejecuta la aplicación.

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

Para crear un servicio App Runner

1. OpenAWSAbra el Explorador de, si aún no está abierto.2. Haga clic en elApp Runnery elijaCreación de servicio.

LaPaleta de comandos delVisualización de.3. ParaSeleccione un tipo de ubicación del código fuente, elijaECRorRepositorio.

Si eligeECR, especifique una imagen de contenedor en un repositorio mantenido por Amazon ElasticContainer Registry. Si eligeRepositorio, especifique un repositorio de código fuente mantenido porun proveedor de repositorio compatible. Actualmente, App Runner admiteGitHubComo proveedor derepositorio de código fuente.

Implementación desde ECR

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

Note

Si especifica un repositorio de la Galería pública de Amazon ECR, asegúrese de quelas implementaciones automáticas estén desactivadas porque App Runner no admiteimplementaciones automáticas para una imagen en un repositorio público ECR.Las implementaciones automáticas se desactivan de forma predeterminada, y esto se indicacuando el icono de la pestañaPaleta de comandos delcuenta con una línea diagonal a travésde él. Si eligió activar las implementaciones automáticas, un mensaje le informará de queesta opción puede incurrir en costos adicionales.

2. Si el archivo dePaleta de comandos delInformes de pasosNo encontrado etiquetas, debe retrocederun paso para seleccionar un repositorio que contenga una imagen de contenedor etiquetada.

3. Si utilizas un registro privado de Amazon ECR, necesitas el rol de accesoECR,ApprunnerecrAccessRole, que permite que App Runner acceda a imágenes de AmazonElastic Container Registry (Amazon ECR) en tu cuenta de. Elija el icono «+» en la pestañaPaleta decomandos delpara crear automáticamente este rol. (No se requiere un rol de acceso si la imagen estáalmacenada en Amazon ECR Public, donde las imágenes están disponibles públicamente).

4. ParaPuerto, ingrese el puerto IP que utiliza el servicio (Puerto8000, por ejemplo).5. ParaConfiguración de variables de entorno, puede especificar un archivo que contenga variables de

entorno que se utilizan para personalizar el comportamiento en la instancia de servicio. O puede omitireste paso.

6. ParaNombra su servicio, introduzca un nombre único sin espacios y presioneEscriba.

28

AWSToolkit for VS Code Guía del usuarioAWS App Runner

7. ParaSeleccione la configuración de la instancia, elija una combinación de unidades de CPU y memoriaen GB para su instancia de servicio.

Cuando se crea el servicio, el estado cambia deCrearDe aEn ejecución.8. Después de que el servicio comience a ejecutarse, haga clic con el botónCopiar URL de servicio.9. Para acceder a la aplicación implementada, pegue la dirección URL copiada en la barra de

direcciones del explorador web.

Implementación desde un repositorio remoto

1. ParaSeleccione una conexión, elija una conexión que vincule GitHub aAWS. Las conexiones queestán disponibles para la selección se enumeran en la pestañaConexiones GitHuben la consola deApp Runner.

2. ParaSeleccionar un repositorio remoto de GitHub, elija o introduzca una URL para el repositorioremoto.

Los repositorios remotos que ya están configurados con la administración de control de origen (SCM)de Visual Studio Code están disponibles para su selección. También puede pegar un vínculo en elrepositorio si no aparece en la lista.

3. ParaSeleccione una ramificación, elija qué rama Git de su código fuente desea implementar.4. ParaElija el origen de configuración, especifique cómo desea definir la configuración de tiempo de

ejecución.

Si eligeUso del archivo de configuración, la instancia de servicio se configura mediante laconfiguración definida por laapprunner.yamlArchivo de configuración. Este archivo se encuentra enel directorio raíz del repositorio de la aplicación.

Si eligeConfigurar todas las opciones aquí, utilice elPaleta de comandosPara especificar lo siguiente:

• Runtime (Tiempo de ejecución):: SeleccionarPython 3orNodejs 12.• Comando de compilación: Introduzca el comando para crear la aplicación en el entorno de tiempo

de ejecución de la instancia de servicio.• Comando de inicio: Escriba el comando para iniciar la aplicación en el entorno de tiempo de

ejecución de la instancia de servicio.5. ParaPuerto, ingrese el puerto IP que utiliza el servicio (Puerto8000, por ejemplo).6. ParaConfiguración de variables de entorno, puede especificar un archivo que contenga variables de

entorno que se utilizan para personalizar el comportamiento en la instancia de servicio. O puede omitireste paso.

7. ParaNombra su servicio, introduzca un nombre único sin espacios y presioneEscriba.8. ParaSeleccione la configuración de la instancia, elija una combinación de unidades de CPU y memoria

en GB para su instancia de servicio.

Cuando se crea el servicio, el estado cambia deCrearDe aEn ejecución.9. Después de que el servicio comience a ejecutarse, haga clic con el botónCopiar URL de servicio.10. Para acceder a la aplicación implementada, pegue la dirección URL copiada en la barra de

direcciones del explorador web.

Note

Si se produce un error en el intento de crear un servicio de App Runner, el servicio muestra unestado deError en la creacióninAWS Explorer. Para obtener sugerencias acerca de la solución deproblemasCuando la creación del servicio fallaen laGuía para desarrolladores de App Runner.

29

AWSToolkit for VS Code Guía del usuarioAWS App Runner

Administración de los servicios de App RunnerDespués de crear un servicio de App Runner, puede administrarlo mediante elAWSPanel del Exploradorpara llevar a cabo las siguientes actividades:

• Pausa y reanudación de los servicios de App Runner (p. 30)• Implementar los servicios de App Runner (p. 30)• Visualización de flujos de registros para App Runner (p. 31)• Eliminar los servicios de App Runner (p. 31)

Pausa y reanudación de los servicios de App Runner

Si necesita desactivar su aplicación web temporalmente y detener la ejecución del código, puede pausarsuAWSApp Runner App Runner reduce la capacidad informática del servicio a cero. Cuando esté listo paraejecutar la aplicación de nuevo, reanude el servicio App Runner. App Runner aprovisiona nueva capacidadinformática, implementa la aplicación en ella y ejecuta la aplicación.

Important

Solo se te facturará App Runner cuando se esté ejecutando. Por lo tanto, puede pausar yreanudar su aplicación según sea necesario para administrar los costos. Esto es particularmenteútil en escenarios de desarrollo y pruebas.

Para pausar el servicio App Runner

1. OpenAWSAbra el Explorador de, si aún no está abierto.2. ExpandaApp RunnerPara ver la lista de servicios.3. Haga clic con el botón derecho en el servicioPause.4. En el cuadro de diálogo que aparece, elijaConfirmar.

Mientras el servicio está en pausa, el estado del servicio cambia deEn ejecuciónDe aPauso dey, acontinuación, aPaused.

Para reanudar el servicio App Runner

1. OpenAWSAbra el Explorador de, si aún no está abierto.2. ExpandaApp RunnerPara ver la lista de servicios.3. Haga clic con el botón derecho en el servicioResume.

Mientras el servicio se reanuda, el estado del servicio cambia deResumeDe aEn ejecución.

Implementar los servicios de App Runner

Si elige la opción de implementación manual para el servicio, debe iniciar explícitamente cadaimplementación en el servicio.

1. OpenAWSAbra el Explorador de, si aún no está abierto.2. ExpandaApp RunnerPara ver la lista de servicios.3. Haga clic con el botón derecho en el servicioIniciar la implementación.4. Mientras la aplicación se está implementando, el estado del servicio cambia deImplementación deDe

aEn ejecución.5. Para confirmar que la aplicación se ha implementado correctamente, haga clic con el botón derecho

en el mismo servicio y elijaCopiar URL de servicio.

30

AWSToolkit for VS Code Guía del usuarioPilas de AWS CloudFormation

6. Para acceder a la aplicación web implementada, pegue la dirección URL copiada en la barra dedirecciones del explorador web.

Visualización de flujos de registros para App Runner

Utilice CloudWatch Logs para monitorizar, almacenar y acceder a los flujos de registros para servicioscomo App Runner. Un flujo de registro es una secuencia de eventos de registro que comparten la mismafuente.

1. ExpandaApp RunnerPara ver la lista de instancias de servicio.2. Expanda una instancia de servicio específica para ver la lista de grupos de registros. (Un grupo de

registros es un grupo de flujos de registros que comparten la misma configuración de retención,monitorización y control de acceso.)

3. Haga clic derecho en un grupo de registros y elijaFlujos de registro.4. Desde elPaleta de comandos del, elija un flujo de registros del grupo.

El editor de código VS muestra la lista de eventos de registro que componen la secuencia. Puedeoptar por cargar eventos más antiguos o más recientes en el editor.

Eliminar los servicios de App RunnerImportant

Si eliminas el servicio App Runner, se elimina permanentemente y se eliminan los datosalmacenados. Si necesita volver a crear el servicio, App Runner necesita recuperar su fuente denuevo y compilarla si se trata de un repositorio de código. Su aplicación web obtiene un nuevodominio de App Runner.

1. OpenAWSAbra el Explorador de, si aún no está abierto.2. ExpandaApp RunnerPara ver la lista de servicios.3. Haga clic derecho en un servicio y elijaEliminar servicio.4. En el navegadorPaleta de comandos delEscriba, introduzcadeleteA continuación, pulseEscribaPara

confirmar.

El servicio eliminado muestra elEliminación dey, a continuación, el servicio desaparece de la lista.

Uso deAWS CloudFormationpilasEl AWS Toolkit for Visual Studio Code ofrece soporte para pilas de AWS CloudFormation. Con el Toolkit forVS Code, puede realizar ciertas tareas conAWS CloudFormationpilas de, como eliminarlas.

Temas• Eliminación de unaAWS CloudFormationpila (p. 31)

Eliminación de unaAWS CloudFormationpilaPuede usar el AWS Toolkit for Visual Studio Code para eliminar pilas de AWS CloudFormation.

Prerequisites

• Asegúrese de que el sistema cumple los requisitos previos especificados enInstalación del Toolkit for VSCode (p. 2).

31

AWSToolkit for VS Code Guía del usuarioAmazon CloudWatch Logs

• Asegúrese de que las credenciales configuradas en Establecimiento de credenciales (p. 4) incluyenacceso de lectura/escritura adecuado al servicio AWS CloudFormation. Si está en elAWSExploradorde, enCloudFormationSi aparece un mensaje del tipo «Error loading CloudFormation resources» (Erroral cargar recursos de CloudFormation), compruebe los permisos asociados a esas credenciales. Loscambios que realice en los permisos tardarán unos minutos en afectar a laAWSExplorador deen VSCode.

Eliminar una pila de CloudFormation

1. En el navegadorAWSExplorador de, abra el menú contextual de laAWS CloudFormationLa pila quedesea eliminar.

2. Elija Delete CloudFormation Stack (Eliminar pila de CloudFormation).3. En el mensaje que aparece, elija Yes (Sí) para confirmar la eliminación.

Una vez que se elimine la pila, ya no aparece en laAWSExplorador de.

Trabajar con CloudWatch Logs mediante laherramienta AWS Toolkit for Visual Studio CodeAmazon CloudWatch Logs le permite centralizar los registros de todos sus sistemas, aplicacionesyAWSque utilice, en un único servicio de gran escalabilidad. A continuación, puede verlos fácilmente,buscarlos códigos de error o patrones específicos, filtrarlos en función de campos específicos o archivarlosde forma segura para futuros análisis. Para obtener más información, consulte¿Qué es AmazonCloudWatch Logs?en laGuía del usuario de Amazon CloudWatch.

Los siguientes temas describen cómo usar la opción AWS Toolkit for Visual Studio Code para trabajar conCloudWatch Logs en unAWSaccount.

Temas• Visualización de los grupos de registros y flujos de registro de CloudWatch mediante la herramienta

AWS Toolkit for Visual Studio Code (p. 33)• Trabajar con los eventos de registro de CloudWatch en flujos de registro mediante el AWS Toolkit for

Visual Studio Code (p. 33)

32

AWSToolkit for VS Code Guía del usuarioAmazon CloudWatch Logs

Visualización de los grupos de registros y flujos de registro deCloudWatch mediante la herramienta AWS Toolkit for VisualStudio CodeUn flujo de registro es una secuencia de eventos de registro que comparten la misma fuente. Cada origenindependiente de registros en CloudWatch Logs constituye un flujo de registros.

Un grupo de registros es un grupo de flujos de registros que comparten la misma configuración deretención, monitorización y control de acceso. Puede definir grupos de logs y especificar los flujos quedeben incluirse en cada uno. No hay límites en el número de flujos de registro que pueden pertenecer a ungrupo de registros.

Para obtener más información, consulteTrabajo con grupos y flujos de logsen laGuía del usuario deAmazon CloudWatch.

Temas• Visualización de grupos y secuencias de registros con la opciónRegistros de

CloudWatchnodo (p. 33)

Visualización de grupos y secuencias de registros con la opciónRegistros deCloudWatchnodo

1. En VS Code, elijaVista,Explorador dePara abrirAWSExplorador de.2. Haga clic en el botón .Registros de CloudWatchPara expandir la lista de grupos de registros.

Los grupos de registro para elAWSLa región se muestra en la pestañaRegistros de CloudWatchNodo.3. Para ver las secuencias de registro en un grupo de registros, haga clic con el botón secundario en el

nombre del grupo de registros y, a continuación, elijaFlujo de registro.

4. Desde elPaleta de comandos del, seleccione una secuencia de registro del grupo que desea ver.

Note

LaPaleta de comandos delmuestra una marca de tiempo para el último evento de cadasecuencia.

LaFlujo de registroEditor (p. 33)se inicia para mostrar los eventos de registro de la secuencia.

Trabajar con los eventos de registro de CloudWatch en flujos deregistro mediante el AWS Toolkit for Visual Studio CodeDespués de abrir elSteam de registro, puede acceder a los eventos de registro en cada secuencia. Loseventos de registro son registros de la actividad registrada por la aplicación o el recurso que se estámonitorizando.

Temas• Visualización y copia de información de flujo de registro (p. 34)• Guardar el contenido del editor de secuencias de registro en un archivo local (p. 34)

33

AWSToolkit for VS Code Guía del usuarioAmazon CloudWatch Logs

Visualización y copia de información de flujo de registro

Cuando abre una secuencia de registro, elFlujo de registromuestra la secuencia de eventos de registro deesa secuencia.

1. Para buscar un flujo de registros que desea ver, abra el cuadro de diálogoFlujo deregistro(consulteVisualización de grupos de registros y flujos de registro de CloudWatch (p. 33)).

Cada línea que muestra un evento tiene una marca de tiempo para mostrar cuándo se registró.2. Puede ver y copiar información sobre los eventos de la transmisión de mediante las siguientes

opciones:

• Ver eventos por hora: Mostrar los eventos de registro más recientes y antiguosseleccionandoCargue eventos más recientesorCargar eventos antiguos.

Note

LaFlujo de registrocarga inicialmente un lote de las 10.000 líneas más recientes de eventosde registro o 1 MB de datos de registro (lo que sea más pequeño). Si eligeCargue eventosmás recientes, el editor muestra los eventos que se registraron después de que se cargóel último lote. Si eligeCargar eventos antiguos, el editor muestra un lote de eventos queocurrieron antes de los que se muestran actualmente.

• Copiar eventos de registro: Seleccione los eventos que desea copiar, haga clic con el botón derechoy seleccioneCopy (Copiar)En el menú.

• Copie el nombre del flujo de registro: Haga clic derecho en la ficha deFlujo de registroeditor yelijaCopiar el nombre del flujo.

Note

También puede utilizar laPaleta de comandos delPara ejecutarAWS: Copiar el nombre delflujo.

Guardar el contenido del editor de secuencias de registro en un archivo local

Puede descargar el contenido del editor de secuencias de registro de CloudWatch en unlogen el equipolocal.

Note

Con esta opción, puede guardar en archivar sólo los eventos de registro que se muestranactualmente en el editor de flujos de registro. Por ejemplo, si el tamaño total de una secuencia deregistro es de 5 MB y sólo se cargan 2 MB en el editor, el archivo guardado también contendrásólo 2 MB de datos de registro. Para mostrar más datos que se van a guardar, elijaCargueeventos más recientesorCargar eventos antiguosen el editor.

1. Para buscar un flujo de registros que copiar, abra el cuadro de diálogoFlujos deregistro(consulteVisualización de grupos de registros y flujos de registro de CloudWatch (p. 33)).

2. Elija el iconoSave (Guardar)junto a la pestaña que muestra el nombre del flujo de registro.

Note

También puede utilizar laPaleta de comandos delPara ejecutarAWS: Guardar contenido deflujo de registro actual.

3. Utilice el cuadro de diálogo para seleccionar o crear una carpeta de descarga para el archivo deregistro y haga clic enSave (Guardar).

34

AWSToolkit for VS Code Guía del usuarioAmazon EventBridge

Trabajo con Amazon EventBridgeLa AWS Toolkit for Visual Studio Code (VS Code) proporciona soporte paraAmazon EventBridge. Con elToolkit for VS Code, puede trabajar con ciertos aspectos de EventBridge, como esquemas.

Temas• Trabajo con esquemas de Amazon EventBridge (p. 35)

Trabajo con esquemas de Amazon EventBridgePuede utilizar el AWS Toolkit for Visual Studio Code (VS Code) para realizar varias operacionesenEsquemas de Amazon EventBridge.

Prerequisites

• Asegúrese de que el sistema cumple los requisitos previos especificados enInstalación del Toolkit for VSCode (p. 2).

• El esquema de EventBridge con el que desea trabajar debe estar disponible en elAWSaccount. Si no loestá, créelo o cárguelo. ConsulteEsquemas de Amazon EventBridgeen laGuía del usuario de AmazonEventBridge.

• Abra el iconoAWSExplorador de (p. 19)Barra lateral.

Visualización de un esquema disponible

1. En el navegadorAWSExplorador de, amplíeEsquemas de.2. Expanda el nombre del registro que contiene el esquema que desea ver. Por ejemplo, muchos de los

esquemas que AWS proporciona están en el registro aws.events.3. Para ver un esquema en el editor, abra el menú contextual del esquema y, a continuación, elija View

Schema (Ver esquema).

35

AWSToolkit for VS Code Guía del usuarioAmazon EventBridge

Búsqueda de un esquema disponible

En el navegadorAWSExplorador de, realice una o varias de las siguientes acciones:

• Escriba el título del esquema que desea buscar. LaAWSExplorador deresalta los títulos de esquema quecontienen una coincidencia. (debe expandir un registro para ver los títulos resaltados).

• Abra el menú contextual de Schemas (Esquemas) y, a continuación, elija Search Schemas (Buscaresquemas). De forma alternativa, expanda Schemas (Esquemas), abra el menú contextual del registroque contiene el esquema que desea buscar y, a continuación, elija Search Schemas in Registry (Buscaresquemas en el registro). En el navegadorBúsqueda de esquemas de EventBridgeEscriba el título delesquema que desea buscar. El cuadro de diálogo muestra los títulos de esquema que contienen unacoincidencia.

Para mostrar el esquema en el cuadro de diálogo, seleccione el título del esquema.

36

AWSToolkit for VS Code Guía del usuarioFunciones AWS Lambda

Generación de código para un esquema disponible

1. En el navegadorAWSExplorador de, amplíeEsquemas de.2. Expanda el nombre del registro que contiene el esquema para el que desea generar el código.3. Haga clic con el botón derecho en el título del esquema y, a continuación, elija Download code

bindings (Descargar vínculos de código).4. En las páginas del asistente que aparecerán, elija lo siguiente:

• La versión del esquema• El lenguaje del vínculo de código• La carpeta del espacio de trabajo donde desea almacenar el código generado en la máquina de

desarrollo local

Trabajo con funciones de AWS LambdaEl AWS Toolkit for Visual Studio Code ofrece soporte para las funciones de AWS Lambda. Con el Toolkitfor VS Code, puede crear código para funciones de Lambda que forman parte deaplicaciones sin servidor.Además puedes invocar funciones de Lambda localmente o enAWS.

Lambda es un servicio de computación completamente administrado que ejecuta su código comorespuesta a eventos generados por código personalizado o de variosAWSComo, por ejemplo, AmazonSimple Storage Service (Amazon S3), Amazon DynamoDB, Amazon Kinesis, Amazon Simple NotificationService (Amazon SNS) y Amazon Cognito.

Temas• Interacción con funciones de Lambda de remotas (p. 37)

Interacción con funciones de Lambda de remotasUsando el Toolkit for VS Code, puede interactuar conAWS LambdaFunciones de varias maneras, como sedescribe más adelante en este tema.

Para obtener más información sobre Lambda, consulte laAWS LambdaGuía para desarrolladores.

37

AWSToolkit for VS Code Guía del usuarioFunciones AWS Lambda

Note

Si ya ha creado funciones de Lambda mediante elAWS Management Consoleo de alguna otramanera, puede invocarlos desde el conjunto de herramientas. Para crear una nueva función(mediante VS Code) que se pueda implementar enAWS LambdaEn primer lugar, debeCrear unaaplicación sin servidor (p. 63).

Temas• Prerequisites (p. 38)• Invocar una función Lambda (p. 38)• Eliminación de una función Lambda (p. 40)• Importar una función Lambda (p. 41)• Cargar una función Lambda (p. 42)

Prerequisites

• Asegúrese de que el sistema cumple los requisitos previos especificados enInstalación del Toolkit for VSCode (p. 2).

• Asegúrese de que las credenciales configuradas en Establecimiento de credenciales (p. 4) incluyenacceso de lectura/escritura adecuado al servicio AWS Lambda. Si está en elAWSExplorador de,enLambda:Si aparece un mensaje del tipo «Error loading Lambda resources» (Error al cargar recursosde Lambda), compruebe los permisos asociados a esas credenciales. Los cambios que realice en lospermisos tardarán unos minutos en afectar a laAWSExplorador deen VS Code.

Invocar una función Lambda

Puede invocar una función Lambda enAWSEn el Toolkit for VS Code.

1. En el navegadorAWSExplorador de, elija el nombre de la función Lambda que desea invocar y, acontinuación, abra su menú contextual.

38

AWSToolkit for VS Code Guía del usuarioFunciones AWS Lambda

2. SeleccionarCómo invocar elAWS.3. En la ventana de invocación que se abre, escriba la entrada que necesita la función de Lambda. La

función de Lambda podría, por ejemplo, requerir una cadena como entrada, como se muestra en elcuadro de texto.

39

AWSToolkit for VS Code Guía del usuarioFunciones AWS Lambda

Verá la salida de la función de Lambda al igual que en cualquier otro proyecto en el que se use VS Code.

Eliminación de una función LambdaTambién puede eliminar una función de Lambda utilizando el mismo menú contextual.

Warning

No utilice este procedimiento para eliminar funciones de Lambda asociadas conAWSCloudFormation(por ejemplo, la función Lambda que se creó cuandoCreación de una aplicaciónsin servidor (p. 63)anteriormente en esta guía). Estas funciones deben eliminarse a través dela pila de AWS CloudFormation.

40

AWSToolkit for VS Code Guía del usuarioFunciones AWS Lambda

1. En el navegadorAWSExplorador deElija el nombre de la función de Lambda que desea eliminar y, acontinuación, abra su menú contextual.

2. Elija Eliminar.3. En el mensaje que aparece, elija Yes (Sí) para confirmar la eliminación.

Una vez eliminada la función, ya no aparece en la lista deAWSExplorador de.

Importar una función Lambda

Puede importar código desde una función remota de Lambda en su espacio de trabajo VS Code paraeditarlo y depurarlo.

Note

El conjunto de herramientas solo admite la importación de funciones de Lambda mediantetiempos de ejecución de Node.js y Python compatibles.

1. En el navegadorAWSExplorador de, elija el nombre de la función Lambda que desea importar y, acontinuación, abra su menú contextual.

2. SeleccionarImportar...3. Elija una carpeta a la que importar el código Lambda. Las carpetas que se encuentren fuera del

espacio de trabajo actual se agregarán al espacio de trabajo actual.

41

AWSToolkit for VS Code Guía del usuarioFunciones AWS Lambda

4. Después de la descarga, el Toolkit agrega el código a su espacio de trabajo y abre el archivo quecontiene el código del controlador Lambda. El Toolkit también crea unconfiguración de lanzamiento,que aparece en el panel de ejecución de código VS para que pueda ejecutar y depurar localmente lafunción Lambda usandoAWS Serverless Application Model. Para obtener más información acerca deluso de AWS SAM, consulte the section called “Ejecución y depuración de una aplicación sin servidordesde la plantilla (local)” (p. 64).

Cargar una función Lambda

Puede actualizar las funciones existentes de Lambda con código local. Actualizar el código de esta manerano utiliza elAWS SAMCLI para la implementación y no crea unAWS CloudFormationpila. Esta funcionalidadpuede cargar una función Lambda con cualquier tiempo de ejecución soportado por Lambda.

Warning

El kit de herramientas no puede comprobar si el código funciona. Asegúrese de que el códigofunciona antes de actualizar las funciones de producción de Lambda.

1. En el navegadorAWSExplorador de, elija el nombre de la función Lambda que desea importar y, acontinuación, abra su menú contextual.

2. SeleccionarCargue Lambda...3. Elige entre las tres opciones para cargar tu función Lambda. Las opciones son:

Cargar un archivo.zip prefabricado

• SeleccionarArchivo zipen el menú Selección rápida.• Elija un archivo.zip de su sistema de archivos y confirme la carga con el diálogo modal. Esto carga

el archivo.zip tal y como está y actualiza inmediatamente el Lambda después de la implementación.

Cargar un directorio como está

• SeleccionarDirectoryen el menú Selección rápida.• Elija un directorio de su sistema de archivos.• SeleccionarNocuando se le pida que cree el directorio, luego confirme la carga con el diálogo

modal. Esto carga el directorio tal y como está y actualiza inmediatamente el Lambda después de laimplementación.

Crear y cargar un directorio

Note

Para ello, se requiere elAWS SAMCLI:

• SeleccionarDirectoryen el menú Selección rápida.• Elija un directorio de su sistema de archivos.• SeleccionarSícuando se le pida que cree el directorio, luego confirme la carga con el diálogo

modal. Esto construye el código en el directorio usando elAWS SAMCLIsam buildy actualizainmediatamente el Lambda después de la implementación.

Note

El kit de herramientas le avisará si no puede detectar un controlador coincidente antes decargarlo. Si desea cambiar el controlador vinculado a la función de Lambda, puede hacerloa través de laAWS Management Consoleo elAWS CLI.

42

AWSToolkit for VS Code Guía del usuarioAmazon S3

Trabajo con Amazon S3Los siguientes temas describen cómo usar la opciónAWS Toolkit for Visual Studio Codepara trabajarconAmazon S3buckets y objetos de unAWSaccount.

Temas• Trabajo con buckets de Amazon S3 (p. 43)• Trabajo con objetos de Amazon S3 (p. 45)

Trabajo con buckets de Amazon S3Todos los objetos almacenados en Amazon S3 residen en un bucket. Puede utilizar los buckets paraagrupar objetos relacionados del mismo modo en que usa un directorio para agrupar archivos en unsistema de archivos.

Temas• Creación de un bucket de Amazon S3 (p. 43)• Adición de una carpeta a un bucket de Amazon S3 (p. 43)• Eliminación de un bucket de Amazon S3 (p. 44)• Configurar la visualización de productos de Amazon S3 (p. 44)

Creación de un bucket de Amazon S3

1. En el navegadorAWSExplorador deEn el botón derecho en elS3y, a continuación, elijaCreación de unbucket. O elija laCreación de un bucketfrente a laS3Nodo.

2. En el navegadorNombre del bucket, escriba un nombre válido para el bucket. PrensaEscribaParaconfirmar.

El nuevo depósito se muestra en la pestañaS3Nodo.

Note

Dado que Amazon S3 permite que el bucket se pueda utilizar como una dirección URL conacceso público, el nombre del bucket que elija deberá ser único de forma global. Si hay otracuenta que ya haya creado un bucket con el nombre que eligió, deberá utilizar otro nombre.Puede consultar laAWSConjunto de herramientasen laSalidaSi no se puede crear un bucket.Por ejemplo, unBucketAlreadyExistsse produce si utiliza un nombre de bucket ya enuso. Para obtener más información, consulte Restricciones y limitaciones de los buckets en laGuía para desarrolladores de Amazon Simple Storage Service.

Después de crear un bucket, puede copiar su nombre y Amazon Resource Name (ARN) en elportapapeles. Haga clic con el botón derecho en la entrada del depósito y seleccione la opcióncorrespondiente en el menú.

Adición de una carpeta a un bucket de Amazon S3

Organiza el contenido de un depósito agrupando objetos en carpetas. También puede crear carpetasdentro de otras carpetas.

1. En el navegadorAWSExplorador de, elija la opciónAmazon S3Para ver la lista de buckets.

43

AWSToolkit for VS Code Guía del usuarioAmazon S3

2. Haga clic con el botón secundario en un bucket o una carpeta y elijaCreate Folder. O elija laCreateFolderfrente al nombre del depósito o carpeta.

3. Escriba unNombre de carpetay, a continuación, pulseEscriba.

Eliminación de un bucket de Amazon S3

Cuando elimina un depósito, también elimina las carpetas y objetos que contiene. Se le pide que confirmeque desea hacer esto antes de que se lleve a cabo la eliminación.

Note

Para eliminar sólo una carpeta,no todo el cubo, utilice elAWS Management Console.

1. En el navegadorAWSExplorador de, elija la opciónS3Para expandir la lista de buckets.2. Haga clic con el botón secundario en el bucket que desea eliminar y, a continuación, elija Delete S3

Bucket (Eliminar bucket de S3).3. Escriba el nombre del bucket para confirmar la eliminación y, a continuación, presioneEscriba.

Note

Si el bucket contiene objetos, el bucket se vacía antes de su eliminación. Esto puede llevaralgún tiempo si es necesario eliminar cada versión de miles de objetos. Se muestra unanotificación una vez completada la eliminación.

Configurar la visualización de productos de Amazon S3

Si trabaja con un gran número de objetos o carpetas de Amazon S3, puede especificar cuántos semuestran a la vez. Cuando se muestra el número máximo, puede elegirCargar máspara mostrar elsiguiente lote.

1. En el código VSBarra de actividades, elijaExtensiones.2. Para el registroAWSExtensión del conjunto de herramientas, elija el icono de configuración y, a

continuación, elijaConfiguración de la extensión.3. En la páginaConfiguración, vaya a la páginaAWS > S3: Máximo de artículos por páginaconfiguración

de.4. Cambie el valor predeterminado al número de elementos S3 que desea mostrar antes de elegir cargar

más.

Note

El rango de valores aceptados está entre 3 y 1000. Esta configuración sólo se aplica alnúmero de objetos o carpetas que se muestran a la vez. Todos los depósitos que ha creadose muestran a la vez. (De forma predeterminada, puede crear hasta 100 buckets en cada unade susAWScuentas.)

5. Cierre elConfiguraciónPara confirmar los cambios.

También puede actualizar la configuración de un archivo con formato JSON seleccionando la opciónAbrirconfiguración (JSON)Icono de la esquina superior derecha de la ventanaConfiguración(Se ha creado elcertificado).

44

AWSToolkit for VS Code Guía del usuarioAmazon S3

Trabajo con objetos de Amazon S3Los objetos son las entidades fundamentales almacenadas en Amazon S3. Los objetos se componen dedatos de objetos y metadatos.

Temas• Cargue un archivo a un bucket de Amazon S3 (p. 45)• Descarga de un objeto de Amazon S3 (p. 46)• Eliminación de un objeto de Amazon S3 (p. 46)• Generación de una URL prefirmada para un objeto de Amazon S3 (p. 46)

Cargue un archivo a un bucket de Amazon S3

Puede utilizar la interfaz Toolkit o elPaleta de comandos delPara cargar un archivo en un bucket.

Ambos métodos le permiten cargar un archivo desde el entorno de un usuario y almacenarlo como unobjeto S3 en elAWSNubes. Puede cargar un archivo a un depósito o a una carpeta que organice elcontenido de ese depósito.

Cargue un archivo en un bucket de S3 mediante la interfaz

1. En el navegadorAWSExplorador de, elija la opciónAmazon S3Para ver la lista de buckets.2. Haga clic con el botón secundario en un bucket o una carpeta de ese bucket y, a continuación,

elijaCargar archivo. O elija laCargar archivofrente al nombre del depósito o carpeta.

Note

Si hace clic con el botón derecho en un objeto S3, puede elegirCargue a principal. Esto lepermite agregar un archivo a la carpeta o al depósito que contiene el archivo seleccionado.

3. Utilizando el administrador de archivos del sistema, seleccione un archivo y, a continuación,elijaCargar archivo.

El archivo seleccionado se carga como un objeto S3 en el depósito o carpeta. La entrada de cadaobjeto describe el tamaño del objeto almacenado y cuánto tiempo hace que se cargó. Puede haceruna pausa sobre la lista del objeto para ver la ruta, el tamaño y la hora en que se modificó por últimavez.

Cargue el archivo actual en un bucket de S3 mediante laPaleta de comandos del

1. Para seleccionar un archivo para cargarlo, elija la pestaña del archivo.2. PrensaCtrl+Mayús+Ppara visualizarPaleta de comandos del.3. En el navegadorPaleta de comandos del, comience a introducir la fraseupload filepara

visualizarAWS: Upload Filecomando. Elija el comando cuando aparezca.4. ParaPaso 1: Seleccione un archivo para cargar, puede elegir el archivo actual o buscar otro archivo.

45

AWSToolkit for VS Code Guía del usuarioAmazon S3

5. ParaPaso 2: Seleccione un bucket de S3 en el que se debe cargarElija un bucket de la lista.

El archivo seleccionado se carga como un objeto S3 en el depósito o carpeta. La entrada de cadaobjeto describe el tamaño del objeto almacenado y cuánto tiempo hace que se cargó. Puede haceruna pausa sobre la lista del objeto para ver la ruta, el tamaño y la hora en que se modificó por últimavez.

Descarga de un objeto de Amazon S3

Puede descargar objetos de un bucket de Amazon S3 desdeAWSNube a su sistema.

1. En el navegadorAWSExplorador de, elija la opciónS3Para ver la lista de buckets.2. En un bucket o en una carpeta de un bucket, haga clic con el botón secundario en un objeto y, a

continuación, elijaDescargar como. O elija laDescargar comoFrente al nombre del objeto.3. Con el administrador de archivos del sistema, seleccione una carpeta de destino, escriba un nombre

de archivo y, a continuación, elijaDescargar.

Después de descargar un archivo, puede abrirlo en la interfaz IDE utilizando la herramientaAWSConjuntode herramientasen elSalidaPestaña. Dependiendo del sistema operativo, presioneCMDorCtrly haga clic enel enlace a la ubicación del archivo.

Eliminación de un objeto de Amazon S3

Puede eliminar permanentemente un objeto si está en un bucket sin control de versiones. Pero para losdepósitos habilitados para versiones, una solicitud de eliminación no elimina permanentemente ese objeto.En su lugar, Amazon S3 inserta un marcador de eliminación en el bucket. Para obtener más información,consulteEliminar versiones de objetosen laAmazon Simple Storage Service Developer Guide.

1. En el navegadorAWSExplorador de, elija la opciónS3Para ver la lista de buckets.2. En un bucket o una carpeta de un bucket, haga clic con el botón secundario en un objeto y, a

continuación, elijaEliminar.3. Elija Delete para confirmar.

Generación de una URL prefirmada para un objeto de Amazon S3

Con las URL prefirmadas, el propietario de un objeto puede compartir objetos privados de Amazon S3con otros otorgando permisos con restricción temporal para descargar los objetos. Para obtener másinformación, consulteCompartir un objeto con una URL prefirmadaen laGuía del usuario de Amazon S3.

1. En el navegadorAWSExplorador de, elija la opciónS3Para ver la lista de buckets.2. En un bucket o una carpeta de un bucket, haga clic con el botón secundario en un objeto y, a

continuación, elijaGenerar URL prefirmadas.3. En el navegadorPaleta de comandos delEscriba el número de minutos que puede utilizar la dirección

URL para obtener acceso al objeto. PrensaEscribapara confirmar.

El código VSStatus Bar (barra de estado)confirma que la URL prefirmada del objeto se copió en elportapapeles.

46

AWSToolkit for VS Code Guía del usuarioAWS Systems Manager

Trabajo con documentos de Systems ManagerAutomationAWS Systems Managerle ofrece visibilidad y control de su infraestructura deAWS. Systems Managerofrece una interfaz de usuario unificada para que pueda ver los datos operativos de variosAWSyautomatice las tareas operativas en suAWSde AWS.

ADocumento de Systems Managerdefine las acciones que Systems Manager realiza en las instanciasadministradas. Un documento de automatización es un tipo de documento de Systems Manager que utilizapara realizar tareas de implementación y mantenimiento comunes como, por ejemplo, crear o actualizaruna imagen de máquina de Amazon (AMI). En este tema se explica cómo crear, editar, publicar y eliminardocumentos de automatización conAWS Toolkit for Visual Studio Code.

Temas• Suposiciones y requisitos previos (p. 47)• Permisos de IAM para los documentos de automatización de Systems Manager (p. 47)• Creación de un documento de Systems Manager Automation (p. 48)• Apertura de un documento de Systems Manager Automation (p. 48)• Edición de un documento de Systems Manager Automation (p. 49)• Publicación de un documento de Systems Manager Automation (p. 49)• Eliminación de un documento de Systems Manager Automation (p. 49)• Ejecución de un documento de Systems Manager Automation (p. 50)• Solución de problemas de los documentos de automatización de Systems Manager en Toolkit for VS

Code (p. 50)

Suposiciones y requisitos previosAntes de comenzar, asegúrese de:

• Ha instalado Visual Studio Code y la última versión delAWS Toolkit for Visual Studio Code. Para obtenermás información, consulte Instalación de AWS Toolkit for Visual Studio Code (p. 2).

• Está familiarizado con el Systems Manager. Para obtener más información, consulte la Guía del usuariode AWS Systems Manager.

• Está familiarizado con los casos de uso de Systems Manager Automation. Para obtener másinformación, consulteAWSAutomatización de Systems Manageren laAWS Systems ManagerGuía delusuario de.

Permisos de IAM para los documentos de automatización deSystems ManagerEn el Toolkit for VS Code debe tener un perfil de credenciales que contenga elAWS Identity and AccessManagement(IAM) necesarios para crear, editar, publicar y eliminar documentos de Systems ManagerAutomation. El siguiente documento de directiva define los permisos de IAM necesarios que se puedenutilizar en una directiva principal:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [

47

AWSToolkit for VS Code Guía del usuarioAWS Systems Manager

"ssm:ListDocuments", "ssm:ListDocumentVersions", "ssm:DescribeDocument", "ssm:GetDocument", "ssm:CreateDocument", "ssm:UpdateDocument", "ssm:UpdateDocumentDefaultVersion", "ssm:DeleteDocument" ], "Resource": "*" } ]}

Para obtener más información sobre cómo actualizar una directiva de IAM, consulteCreación dedirectivas de IAMen laIAM User Guide. Para obtener más información sobre cómo configurar el perfil decredenciales, consulteConfigurar suAWScredenciales (p. 5).

Creación de un documento de Systems Manager AutomationPuede crear un nuevo documento de automatización enJSONorYAMLUso de Visual Studio Code. Cuandocree un nuevo documento de automatización, se presentará en un archivo sin título. Puede asignar unnombre a su archivo y guardarlo en VS Code, sin embargo, el nombre del archivo no es visible paraAWS.

Para crear un nuevo documento de Automation

1. Abra el código VS.2. En la páginaVistaEn el menú, elija.Paleta de comandos delPara abrir la paleta de comandos.3. En la paleta de comandos, escribaAWS: Crear un nuevo documento de Systems Manager localmente.4. Elija una de las plantillas de inicio para un ejemplo de Hello World.5. Elija JSON o YAML.

Se crea un nuevo documento de automatización.

Note

Su nuevo documento de automatización en VS Code no aparece automáticamente enAWS. Debepublicarlo enAWSantes de que pueda ejecutarlo.

Apertura de un documento de Systems Manager AutomationUtilice elAWSExplorador para encontrar los documentos existentes Systems Manager Automation. Cuandoabre un documento de automatización existente, aparece como un archivo sin título en VS Code.

Para abrir el documento de automatización

1. Abra el código VS.2. En la navegación de la izquierda, elijaAWSpara abrirAWSExplorador de.3. En el navegadorAWSExplorador de, paraSystems ManagerElija el icono de descarga del documento

que desea abrir y, a continuación, elija la versión del documento. El archivo se abrirá en el formato deesa versión. De lo contrario, elijaDescargar como JSONorDescargar como YAML.

Note

Guardar localmente un documento de automatización como un archivo en VS Code no hace queaparezca enAWS. Debe publicarse enAWSantes de ejecutar.

48

AWSToolkit for VS Code Guía del usuarioAWS Systems Manager

Edición de un documento de Systems Manager AutomationSi posee algún documento de Automatización, aparecerán en elPropiedad de Mede los documentosde Systems Manager en elAWSExplorador de. Puede poseer documentos de automatización que yaexisten enAWS, y puede poseer documentos nuevos o actualizados que haya publicado anteriormenteenAWSdesde VS Code.

Cuando abre un documento de Automatización para editarlo en VS Code, puede hacer más con él que enelAWS Management Console. Por ejemplo:

• Hay validación de esquema en ambosJSONyYAMLFormato de.• Hay fragmentos disponibles en el editor de documentos para crear cualquiera de los tipos de pasos de

automatización.• Hay soporte de autocompletar en varias opciones enJSONyYAML.

Trabajo con versionesLos documentos de automatización de Systems Manager utilizan versiones para la administración decambios. Puede elegir la versión predeterminada para un documento de automatización en VS Code.

Para establecer una versión predeterminada

• En el navegadorAWSExplorador, vaya al documento en el que desee establecer la versiónpredeterminada, abra el menú contextual (haga clic con el botón derecho) del documento yseleccioneEstablecer la versión predeterminada.

Note

Si el documento elegido sólo tiene una versión, no podrá cambiar la predeterminada.

Publicación de un documento de Systems Manager AutomationDespués de editar el documento de automatización en VS Code, puede publicarlo enAWS.

Para publicar el documento de automatización

1. Abra el documento de Automation que desee publicar mediante el procedimiento descrito enAperturade un documento de Systems Manager Automation (p. 48).

2. Realice los cambios que desee publicar. Para obtener más información, consulte Edición de undocumento de Systems Manager Automation (p. 49).

3. En la parte superior derecha del archivo abierto, elija el icono de carga.4. En el cuadro de diálogo de flujo de trabajo de publicación, elija laAWSRegión en la que desea publicar

el documento de Automation.5. Si va a publicar un documento nuevo, elijaCreación rápida. En caso contrario, elija.Actualización

rápidapara actualizar un documento de automatización existente en eseAWSRegión .6. Escriba el nombre de este documento de automatización.

Cuando publica una actualización en un documento de automatización existente enAWS, se agrega unanueva versión al documento.

Eliminación de un documento de Systems Manager AutomationPuede eliminar documentos de automatización en VS Code. Al eliminar un documento de automatización,se eliminan el documento y todas las versiones del documento.

49

AWSToolkit for VS Code Guía del usuarioAWS Systems Manager

Important

• Eliminar es una acción destructiva que no se puede deshacer.• Al eliminar un documento de automatización que ya se ha ejecutado no se elimina elAWSque

se crearon o modificaron cuando se ejecutó.

Para eliminar el documento de automatización

1. Abra el código VS.2. En la navegación de la izquierda, elijaAWSpara abrirAWSExplorador de.3. En el navegadorAWSExplorador de, paraSystems Manager, abra el menú contextual (haga clic con el

botón derecho) del documento que desea eliminar y elijaDocumento de eliminación.

Ejecución de un documento de Systems Manager AutomationUna vez que el documento de automatización se haya publicado enAWS, puede ejecutarlo pararealizar tareas en su nombre en suAWSaccount. Para ejecutar el documento de automatización,utilice la herramientaAWS Management Console, las API de Systems Manager, elAWS CLI, o elAWSTools for PowerShell. Para obtener instrucciones sobre cómo ejecutar un documento de Automation,consulteEjecución de una automatización sencillaen laAWS Systems ManagerGuía del usuario de.

Alternativamente, si desea utilizar una de lasAWSSDK con las API de Systems Manager para ejecutar eldocumento de automatización, consulte laAWSReferencias del SDK.

Note

La ejecución de un documento de automatización puede crear nuevos recursos enAWSy puedeincurrir en costos de facturación. Le recomendamos encarecidamente que comprenda lo quecreará su documento de automatización en su cuenta antes de ejecutarlo.

Solución de problemas de los documentos de automatización deSystems Manager en Toolkit for VS CodeGuardé mi documento de automatización en VS Code, pero no lo veo enAWS Management Console.

Guardar un documento de automatización en VS Code no publica el documento de automatizaciónenAWS. Para obtener más información sobre la publicación del documento de Automation,consultePublicación de un documento de Systems Manager Automation (p. 49).

Error al publicar mi documento de automatización con un error de permisos.

Comprobación de queAWStiene los permisos necesarios para publicar documentos de automatización.Si desea ver un ejemplo de política de permisos, consulte Permisos de IAM para los documentos deautomatización de Systems Manager (p. 47).

He publicado mi documento de automatización enAWS, pero no lo veo en elAWS Management Console.

Asegúrese de que ha publicado el documento en el mismoAWSRegión en la que estás navegando enelAWS Management Console.

He eliminado mi documento de automatización, pero todavía se me está facturando por los recursos queha creado.

Al eliminar un documento de automatización no se eliminan los recursos que creó o modificó. Puedeidentificar elAWSque ha creado a partir de laAWSConsola de administración de facturación, explora tuscargos y elige qué recursos quieres eliminar desde allí.

50

AWSToolkit for VS Code Guía del usuarioAWS Step Functions

Uso de AWS Step FunctionsLa AWS Toolkit for Visual Studio Code (VS Code) proporciona soporte paraAWS Step Functions. Con elToolkit for VS Code, puede crear, actualizar y ejecutar máquinas de estado de Step Functions.

Temas• Uso de AWS Step Functions (p. 51)

Uso de AWS Step FunctionsPuede utilizar el AWS Toolkit for Visual Studio Code (VS Code) para realizar varias operacionesconMáquinas de estado de.

Temas• Prerequisites (p. 51)• Trabajar con máquinas de estado en VS Code (p. 51)• Plantillas de las máquinas (p. 55)• Visualización de gráficos de máquina de estado (p. 55)• Fragmentos de código (p. 56)• Finalización y validación de código (p. 57)

Prerequisites

• Asegúrese de que el sistema cumple los requisitos previos especificados enInstalación del Toolkit for VSCode (p. 2)y, a continuación, instale el kit de herramientas.

• Asegúrese de haber configurado sus credenciales antes de abrir elAWSExplorador de.

Trabajar con máquinas de estado en VS Code

Puede utilizar VS Code para interactuar con máquinas de estado remotas y desarrollar máquinas deestado localmente en formato JSON o YAML. Puede crear o actualizar máquinas de estado, mostrar lasmáquinas de estado existentes, ejecutarlas y descargarlas. VS Code también le permite crear nuevasmáquinas de estado a partir de plantillas, ver una visualización de su máquina de estado y proporcionafragmentos de código, finalización de código y validación de código.

Lista de máquinas de estado existentes

Si ya ha creado máquinas de estado, puede ver una lista de ellas:

1. Abra el iconoAWSExplorador de.2. Seleccione Step Functions3. Compruebe que muestra todas las máquinas de estado de su cuenta.

51

AWSToolkit for VS Code Guía del usuarioAWS Step Functions

Descargue una máquina de estado

Para descargar una máquina de estado:

1. En el navegadorAWSExplorador de, haga clic con el botón derecho en la máquina de estado que deseadescargar.

2. Seleccione Download (Descargar) y, a continuación, seleccione la ubicación en la que desea descargarla máquina de estado.

3. Verifique que se haya descargado correctamente.

Creación de una máquina de estado

Puede crear una nueva máquina de estado usted mismo o puede utilizar una plantilla. Para obtener másinformación sobre cómo crear una máquina de estado a partir de una plantilla, consulte la sección StateMachine Template (Plantillas de máquina de estado). Para crear una nueva máquina de estado:

1. Cree un nuevo archivo de Lenguaje de estados de Amazon (ASL) con la definición de máquina deestado. Utiliza el menú de la parte inferior derecha para configurarlo como lenguaje de estados deAmazon.

2. Seleccione Publish to Step Functions (Publicar en Step Functions).

52

AWSToolkit for VS Code Guía del usuarioAWS Step Functions

3. Seleccione Quick Create (Creación rápida), elija un rol y asigne un nombre a su máquina de estado.

Actualización de la máquina de estado

Para actualizar una máquina de estado

1. Edite el archivo ASL con la definición de máquina de estado.2. Seleccione Publish to Step Functions (Publicar en Step Functions).

3. Seleccione Quick Update (Actualización rápida), y, a continuación, seleccione la máquina de estado quedesea actualizar.

53

AWSToolkit for VS Code Guía del usuarioAWS Step Functions

Ejecución de una máquina de estado

Para ejecutar una máquina de estado

1. En el navegadorAWSExplorador de, haga clic con el botón derecho en la máquina de estado que deseaejecutar.

2. Proporcione una entrada para la máquina de estado. Puede probar la entrada desde un archivo y laentrada en un cuadro de texto.

3. Inicie la máquina de estado y verifique que se ejecuta correctamente.

54

AWSToolkit for VS Code Guía del usuarioAWS Step Functions

Plantillas de las máquinas

Cuando crea una máquina de estado, tiene la opción de crearla a partir de una plantilla. La plantillacontiene una definición de máquina de estado de ejemplo con varios estados de uso común y proporcionaun punto de partida. Para utilizar plantillas de máquina de estado:

1. Abra el iconoPaleta de comandos delen VS Code.2. SelectAWS: Crear una nueva máquina de estado Step Functions.3. Elija la plantilla que desea utilizar.

4. Elija si desea utilizar el formato de plantilla JSON o YAML.

Visualización de gráficos de máquina de estado

Las visualizaciones de gráficos le permiten ver cómo se ve su máquina de estado en formato gráfico.Cuando crea una visualización gráfica, se abrirá otra pestaña y mostrará una visualización del JSON oYAML de la máquina de estado. A continuación, puede comparar la definición de máquina de estado queestá escribiendo simultáneamente con su visualización. A medida que cambie la definición de la máquinade estado, la visualización se actualizará.

Note

Para crear una visualización de una definición de máquina de estado, la definición debe estarabierta en el editor activo. Si cierra o cambia el nombre del archivo de definición, la visualizaciónse cerrará.

Para crear una visualización de gráfico de máquina de estado:

1. Defina su máquina de estado.2. Abra el iconoPaleta de comandos delen VS Code.3. Para crear una visualización, utilice el botón de visualización en la esquina superior derecha o

elijaAWSGráfico de máquina de estado de.

55

AWSToolkit for VS Code Guía del usuarioAWS Step Functions

Fragmentos de código

Los fragmentos de código le permiten insertar secciones cortas de código. Para usar fragmentos decódigo:

1. Abra un archivo y guárdelo con la extensión.asl.jsonpara el formato JSON, o.asl.yamlpara elformato YAML.

2. Cree una nueva máquina de estado con la propiedad States (Estados).3. Coloque el cursor dentro de States (Estados).4. Utilice la combinación de teclas Control + Space y seleccione su fragmento de código preferido.5. Utilice Tab para recorrer la variable y los parámetros en el fragmento de código.6. Pruebe los fragmentos Retry y Catch colocando el cursos en el estado relacionado.

56

AWSToolkit for VS Code Guía del usuarioAWS Step Functions

Finalización y validación de código

Para ver cómo funciona la finalización del código:

1. Cree varios estados.2. Coloque el cursor detrás de una propiedad Next (Siguiente), StartAt (EmpezarEn) o Default

(Predeterminado).3. Utilice la combinación de teclas Control + Space para enumerar las finalizaciones disponibles. Se

puede acceder a propiedades adicionales utilizando Control + Space de nuevo y se basarán en elType de State.

4. A medida que trabaje, se llevará a cabo la validación de código para:• Propiedades que faltan• Valores incorrectos• Estado no terminal• Estados inexistentes a los que se señala

57

AWSToolkit for VS Code Guía del usuarioAmazon ECS

Trabajar con Amazon Elastic Container ServiceLa AWS Toolkit for Visual Studio Code proporciona cierto soporte paraAmazon Elastic Container Service(Amazon ECS). El Toolkit for VS Code le ayuda en determinados trabajos relacionados con Amazon ECS,como la creación de definiciones de tareas.

Temas• Uso de archivos de definición de tareas de IntelliSense para Amazon ECS (p. 58)

Uso de archivos de definición de tareas de IntelliSensepara Amazon ECSUna de las opciones que tiene al trabajar con Amazon Elastic Container Service (Amazon ECS) es creardefiniciones de tareas, tal y como se describe enCómo crear una definición de tareadesde lasAmazonElastic Container Service. Cuando instale el AWS Toolkit for Visual Studio Code La instalación incluye lafuncionalidad de IntelliSense para los archivos de definición de tareas de Amazon ECS.

Prerequisites• Asegúrese de que el sistema cumple los requisitos previos especificados enInstalación del Toolkit for VS

Code (p. 2).

Use IntelliSense en archivos de definición de tareas de AmazonECSEl siguiente ejemplo muestra cómo puede sacar partido a IntelliSense en archivos de definición de tareasde Amazon ECS.

1. Cree un archivo JSON para la definición de tareas de Amazon ECS. El nombre del archivo debecontener ecs-task-def.json al final, pero puede tener caracteres adicionales al principio.

Para este ejemplo, cree un archivo denominado my-ecs-task-def.json.2. Abra el archivo en un editor de VS Code y escriba las llaves iniciales.3. Escriba la letra «c» como si quisiera agregar cpu a la definición. Observe el cuadro de diálogo

IntelliSense que se abre, que es similar al siguiente.

58

AWSToolkit for VS Code Guía del usuarioAWS CDKExplorador de

Uso delAWS CDKExplorador deEsta es una documentación preliminar para una característica en versión de vista previa. Está sujeta acambios.

LaAWS CDKExplorador dele permite trabajar conAWS Cloud Development Kit (CDK)aplicaciones,oaplicaciones. Puede encontrar información detallada sobre elAWS CDKen laAWS Cloud Development Kit(CDK)Guía para desarrolladores.

Las aplicaciones de AWS CDK se componen de bloques constitutivos, conocidos como constructos,que incluyen definiciones para las pilas de AWS CloudFormation y los recursos de AWS que contienen.Mediante laAWS CDKExplorador de, puede visualizar elPilas deyrecursosque se definen enAWSCDKConstrucciones de Esta visualización se proporciona en unVista de árbolEn un panel de Explorerdentro del editor de código de Visual Studio (VS Code). Vea una perspectiva general deAWSCDKExplorador deen laNavegación (p. 20)Tema.

En esta sección se explica cómo obtener acceso a laAWS CDKExplorador deen el editor de código VS. Sesupone que ya haInstalado y configurado (p. 2)el Toolkit for VS Code en su sistema.

Note

Puede deshabilitar elAWS CDKExplorador depara que no se muestre en el editor de código VS.En el menú File (Archivo), elija Preferences (Preferencias) y Settings (Configuración). Luegoingrese «cdk» en elBúsqueday desactive la casillaHabilitación deAWSExplorador de CDK.

Temas• Uso deAWS CDKAplicaciones de (p. 59)

Uso deAWS CDKAplicaciones de

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

59

AWSToolkit for VS Code Guía del usuarioAplicaciones de AWS CDK

UsarAWS CDKExplorador deen laAWSToolkit for VS Code de para visualizar y trabajar conAWSCDKaplicaciones.

Prerequisites• Asegúrese de que el sistema cumple los requisitos previos especificados enInstalación del Toolkit for VS

Code (p. 2).• Instalación delAWS CDK, como se describe en las primeras secciones deIntroducción aAWSCDKen

laAWS Cloud Development Kit (CDK)Guía para desarrolladores.

Important

La versión de AWS CDK debe ser 1.17.0 o posterior. Use cdk --version en la línea decomandos para ver qué versión se está ejecutando.

Visualizar unAWS CDKrevisiones deMediante laAWS CDKExplorador de, puede crear o cargar una aplicación de CDK o una aplicación deexistente. A continuación, puede visualizar elPilas deyrecursosque se definen en las construcciones deCDK de esa aplicación.

Realice los primeros pasos delTutorial Hello Worlden laAWS CDKGuía para desarrolladores. Deténgasecuando llegue al paso denominado Deploying the Stack (Implementación de la pila). Puede ejecutar loscomandos proporcionados en el tutorial, por ejemplo,mkdirycdk init, en una línea de comandos delsistema operativo o en unTerminaldentro del editor de código VS.

Después de completar la primera parte del tutorial de CDK, cargue la carpeta resultante en el editor decódigo de VS si aún no está cargada. En la parte inferior del cuadro deExplorador de código VSbarralateral encontrarAWS CDKExplorador dey, a continuación, abra la vista de árbol de la aplicación, como semuestra.

60

AWSToolkit for VS Code Guía del usuarioAplicaciones de AWS CDK

La vista de árbol le proporciona una representación visual de la información en el cuadro detree.jsondela aplicación CDK, que se crea al ejecutar elcdk synthcomando. El archivo se encuentra en el directoriocdk.out de la aplicación.

Notas importantes

• Cuando carga aplicaciones de CDK en el editor de código de VS, puede cargar varias carpetas a la vez.Cada carpeta puede contener varias aplicaciones de CDK, como se muestra en la imagen anterior. El

61

AWSToolkit for VS Code Guía del usuarioAWS Serverless Application

Explorador de AWS CDK encuentra aplicaciones en el directorio raíz del proyecto y sus subdirectoriosdirectos.

• Al realizar los primeros pasos del tutorial, puede observar que el último comando que ejecuta es cdksynth, que genera el archivo tree.json. Si cambia aspectos de una aplicación de CDK, por ejemplo,si agrega más recursos, debe ejecutar ese comando de nuevo para ver los cambios reflejados en la vistade árbol.

Realice otras operaciones en unAWS CDKaplicaciónPuede utilizar el editor de código de VS para realizar otras operaciones en una aplicación de CDK, tal ycomo lo haría utilizando la línea de comandos de su sistema operativo u otras herramientas. Por ejemplo,puede actualizar los archivos de código en el editor e implementar la aplicación mediante un códigoVSTerminal.

Para probar este tipo de acciones, utilice el editor de código VS para continuar con elTutorial Hello WorldenlaAWS CDKGuía para desarrolladores. Asegúrese de realizar el último paso,Destruir los recursos de laaplicación, de modo que no incurra en costos inesperados para suAWSaccount.

Cómo trabajar con aplicaciones sin servidorLa AWS Toolkit for Visual Studio Code ofrece soporte paraaplicaciones sin servidor. Utilizando el Toolkit forVS Code, puede crear aplicaciones sin servidor que contenganAWS Lambday, a continuación, implementelas aplicaciones en unAWS CloudFormationpila.

Temas• Requisitos previos (p. 62)• Permisos de IAM para aplicaciones sin servidor (p. 63)• Creación de una nueva aplicación sin servidor (local) (p. 63)• Abrir una aplicación sin servidor (local) (p. 64)• Ejecución y depuración de una aplicación sin servidor desde la plantilla (local) (p. 64)• Implementar una aplicación sin servidor enAWSCloud (p. 65)• Eliminar una aplicación sin servidor deAWSCloud (p. 66)• Ejecutar y depurar funciones de Lambda directamente desde el código (p. 67)• Ejecución y depuración de recursos locales de Amazon API Gateway (p. 69)• Opciones de configuración para depurar aplicaciones sin servidor (p. 72)• Solución de problemas de aplicaciones sin servidor (p. 76)

Requisitos previos• Asegúrese de que su sistema cumple los requisitos previos requeridos especificados enInstalación

deAWS Toolkit for Visual Studio Code (p. 2).• Instalación delAWS Serverless Application Model(AWS SAM)(CLI) y sus requisitos previos. Consulte CLI

de AWS SAM CLI en los requisitos previos de la instalación (p. 2). Si Visual Studio Code está abierto alrealizar estas instalaciones, es posible que deba cerrar y volver a abrir el editor.

• Identificación de su valor predeterminadoAWSLa región en suAWSarchivo de configuración. Paraobtener más información, consulteOpciones de los archivos de configuración y credencialesen laAWSCommand Line InterfaceGuía del usuario de. Si Visual Studio Code está abierto al actualizar el archivode configuración, es posible que deba cerrar y volver a abrir el editor.

62

AWSToolkit for VS Code Guía del usuarioPermisos de IAM para aplicaciones sin servidor

• Después de instalar el SDK de lenguaje, asegúrese de configurar la cadena de herramientas (p. 16).• Para asegurarse de que puede acceder a laCodeLenscaracterística deAWS SAM, instale el

archivoCompatibilidad con YAMLExtensión VS Code.

Permisos de IAM para aplicaciones sin servidorEn el Toolkit for VS Code debe tener un perfil de credenciales que contenga elAWS Identity and AccessManagement(IAM) necesarios para implementar y ejecutar aplicaciones sin servidor. Debe tener accesode lectura/escritura adecuado a los siguientes servicios: AWS CloudFormationIAM, Lambda, Amazon APIGateway, Amazon Simple Storage Service (Amazon S3) y Amazon Elastic Container Registry (AmazonECR).

Para obtener información acerca de cómo garantizar que tiene los permisos de necesarios paraimplementar y ejecutar aplicaciones sin servidor, consultePermisosen laAWS Serverless ApplicationModelGuía para desarrolladores. Para obtener información sobre cómo configurar el perfil de credenciales,consulteConfigurar suAWScredenciales (p. 5).

Creación de una nueva aplicación sin servidor (local)En este procedimiento se muestra cómo crear una aplicación sin servidor con el Toolkit for VS CodemedianteAWS SAM. El resultado de este procedimiento es un directorio local en el host de desarrolloque contiene una aplicación de ejemplo sin servidor, que puede compilar, probar localmente, modificar eimplementar en elAWSCloud.

1. Para abrirPaleta de comandos del, elijaVista,Paleta de comandos delY a continuación,introduzcaAWS.

2. SeleccionarAWS: Crear nueva aplicación de SAM.

Note

Si el archivo deAWS SAMCLI no está instalado, aparece un error en la esquina inferiorderecha del editor de código VS. Si esto sucede, compruebe que ha cumplido todoslosRequisitos previos (p. 62).

3. Elija el tiempo de ejecución para suAWS SAMrevisiones de.

Note

Si selecciona uno de los tiempos de ejecución con «(Imagen)», su aplicación es el tipo depaqueteImage. Si selecciona uno de los tiempos de ejecución sin «(Imagen)», su aplicaciónesZip. Para obtener más información acerca de la diferencia entreImageyZiptipos depaquetes, consultePaquetes de implementación de Lambdaen laAWS LambdaGuía paradesarrolladores.

4. Elija una ubicación para el nuevo proyecto. Puede utilizar una carpeta de espacio de trabajo existentesi está abierta, seleccionar una existente en Select a different folder (Seleccionar una carpetadiferente) o crear una nueva y seleccionarla. Para este ejemplo, elija There are no workspace foldersopen (No hay carpetas de espacio de trabajo abiertas) para crear una carpeta denominada MY-SAM-APP.

5. Escriba un nombre para el proyecto. Para este ejemplo, use my-sam-app-nodejs. Después depulsarEscribaEl Toolkit for VS Code tarda unos momentos en crear el proyecto.

63

AWSToolkit for VS Code Guía del usuarioAbrir una aplicación sin servidor (local)

Cuando se crea el proyecto, la aplicación se añade al espacio de trabajo actual. Debería aparecer en laventana Explorer (Explorador).

Abrir una aplicación sin servidor (local)Para abrir una aplicación sin servidor en el host de desarrollo local, abra la carpeta que contiene el archivode plantilla de la aplicación.

1. Desde lasArchivo, elijaAbrir carpeta....2. En el navegadorAbrir carpetaDesplácese a la carpeta de la aplicación sin servidor que desea abrir.3. Elija el iconoSeleccionar carpetaBotón.

Cuando abre la carpeta de una aplicación, se agrega a la carpetaExplorador deventana.

Ejecución y depuración de una aplicación sin servidordesde la plantilla (local)Puede utilizar el Toolkit for VS Code para configurar cómo depurar aplicaciones sin servidor y ejecutarlaslocalmente en su entorno de desarrollo.

Empieza a configurar el comportamiento de depuración mediante el código VSCodeLenspara identificaruna función de Lambda elegible. CodeLens permite interacciones conscientes de contenido con sucódigo fuente. Para obtener información acerca de cómo asegurarse de que puede acceder a la funciónCodeLens, consulte laRequisitos previos (p. 62)de la sección que se ha expuesto anteriormente en estetema.

Note

En este ejemplo, depurar una aplicación que utiliza JavaScript. Sin embargo, puede usar Toolkitpara funciones de depuración de código VS con los siguientes lenguajes y tiempos de ejecución:

• C#: .NET Core 2.1, 3.1; .NET 5.0• JavaScript/TypeScript — Node.js 10.x, 12.x, 14.x• : 2.7, 3.6, 3.7, 3.8, 3.9• Java — 8, 8.al2, 11• Go — 1.x

Su elección de idioma también afecta a la forma en que CodeLens detecta controladores Lambdaelegibles. Para obtener más información, consulte Ejecutar y depurar funciones de Lambdadirectamente desde el código (p. 67).

En este procedimiento, utilizará la aplicación de ejemplo creada en la ventana deCreación de una nuevaaplicación sin servidor (local) (p. 63)La sección expuesta anteriormente en este tema.

1. Para ver los archivos de la aplicación en el Explorador de archivos de VS Code, elijaVista,Exploradorde.

2. En la carpeta de la aplicación (por ejemplo,mi-sample-app), abra eltemplate.yamlfile.

Note

Si utiliza una plantilla con un nombre diferente detemplate.yaml, el indicador CodeLensno está disponible automáticamente en el archivo YAML. Esto significa que debe agregarmanualmente una configuración de depuración.

64

AWSToolkit for VS Code Guía del usuarioImplementar una aplicación sin servidor enAWSCloud

3. En el editor detemplate.yamlO bien, vaya a laResourcesde la plantilla que define losrecursos sin servidor. En este caso, este es elHelloWorldFunctionTipo de recursodeAWS::Serverless::Function.

En el indicador CodeLens para este recurso, elijaAñadir configuración de depuración.4. En el navegadorPaleta de comandos del, seleccione el tiempo de ejecución en el queAWS SAMse

ejecutará.5. En el editor para ellaunch.json, edite o confirme los valores de las siguientes propiedades de

configuración:

• "name"— Introduzca un nombre fácil de leer para que aparezca en el cuadro dediálogoConfiguraciónen el campoEjecución devista.

• "target": asegúrese de que el valor es"template"De modo queAWS SAMLa plantilla es elpunto de entrada de la sesión de depuración.

• "templatePath"— Introduzca una ruta relativa o absoluta para eltemplate.yamlfile.• "logicalId"— Asegúrese de que el nombre coincida con el especificado en elRecursosSección

sobre de laAWS SAMplantilla de. En este caso, es elHelloWorldFunctiondetipoAWS::Serverless::Function.

Para obtener más información acerca de estas y otras entradas de lalaunch.json,consulteOpciones de configuración para depurar aplicaciones sin servidor (p. 72).

6. Si está satisfecho con la configuración de depuración, guardelaunch.json. A continuación, parainiciar la depuración, elija el botón verde «reproducir» en elRUNvista.

Cuando se inician las sesiones de depuración, elCONSOLA DE DEPURACIÓNMuestra la salidade la depuración y muestra los valores devueltos por la función Lambda. (Al Depuración deAWSSAMaplicaciones, elAWSConjunto de herramientasse selecciona comoSalidacanal en elSalidaPanelde.)

Implementar una aplicación sin servidor enAWSCloudEn este ejemplo se muestra cómo implementar la aplicación sin servidor que creó en la sección anterior(Creación de una nueva aplicación sin servidor (local) (p. 63)) a laAWSEn la nube utilizando el Toolkitfor VS Code.

Antes de realizar una implementación, asegúrese de que los elementos siguientes estén cubiertos:

• Para aplicaciones con tipo de implementaciónZip, asegúrese de tener un nombre de bucket de AmazonS3 único a nivel mundial para usar en la implementación.

• Para aplicaciones con tipo de implementaciónImage, asegúrese de tener un nombre de depósito únicode Amazon S3 a nivel global y un URI de repositorio de Amazon ECR para utilizar en la implementación.

Para obtener más información acerca de los tipos de paquetes de Lambda, consultePaquetes deimplementación de Lambdaen laAWS LambdaGuía para desarrolladores.

Para implementar una aplicación sin servidor, siga estos pasos:

1. Para abrirPaleta de comandos del, elijaVista,Paleta de comandos delY a continuación,introduzcaAWS.

2. SeleccionarAWS: Implemente la aplicación SAM.

65

AWSToolkit for VS Code Guía del usuarioEliminar una aplicación sin servidor deAWSCloud

3. Elija el archivo template.yaml que desea utilizar para la implementación.4. Elija el iconoAWSRegión en la que desea realizar la implementación.5. Escriba el nombre de un bucket de Amazon S3 que se pueda utilizar en esta implementación. El

bucket debe estar en la región en la que vaya a realizar la implementación.Warning

El nombre del bucket de Amazon S3 debe ser único globalmente entre todos los nombres debuckets existentes en Amazon S3. Por lo tanto, debe agregar un identificador único al nombreindicado en el siguiente ejemplo, o elegir un nombre diferente.

6. Si su aplicación sin servidor incluye una función con tipo de paqueteImageEscriba el nombre de unrepositorio de Amazon ECR que se pueda utilizar en esta implementación. El repositorio debe estar enla región en la que vaya a realizar la implementación.

7. Introduzca el nombre para la pila implementada, que puede ser nuevo o existente.8. Compruebe el éxito de la implementación enSALIDAdel código VS.

Si se produce un error, aparece un mensaje en la parte inferior derecha similar al siguiente:

Si esto sucede, compruebe el texto de la pestaña OUTPUT (Salida) para obtener más información. Acontinuación se muestra un ejemplo de información sobre un error:

Error with child process: Unable to upload artifact HelloWorldFunction referenced by CodeUri parameter of HelloWorldFunction resource.S3 Bucket does not exist. Execute the command to create a new bucketaws s3 mb s3://pbart-my-sam-app-bucketAn error occurred while deploying a SAM Application. Check the logs for more information by running the "View AWS Toolkit Logs" command from the Command Palette.

En este ejemplo, el error se ha producido porque el bucket de Amazon S3 no existía.

Si se produce un error, también puede ver la AWS Toolkit mediante la paleta de comandos. Para ello,vaya a laVistaMenú, elijaPaleta de comandos del, introduzcaAWS, y elijaAWS: Vista AWS ToolkitRegistros.

Cuando se haya realizado la implementación, verá la aplicación en laAWSExplorador de. Para obtenerinformación acerca de cómo invocar la función Lambda que se creó como parte de la aplicación,consulteInteracción con funciones de Lambda de remotas (p. 37).

Eliminar una aplicación sin servidor deAWSCloudEliminar una aplicación sin servidor implica eliminar elAWS CloudFormationque ha implementadopreviamente en el archivoAWSCloud. Tenga en cuenta que este procedimiento no elimina el directorio dela aplicación del host local.

66

AWSToolkit for VS Code Guía del usuarioEjecutar y depurar funciones de

Lambda directamente desde el código

1. Abra la AWSExplorador de (p. 23).2. En el navegadorAWS: Explorador de, expanda la región que contiene la aplicación implementada que

desea eliminar y, a continuación, expandaAWS CloudFormation.3. Abra el menú contextual (con el botón derecho del ratón) del nombre de laAWS CloudFormationPila

que corresponde a la aplicación sin servidor que desea eliminar y, a continuación, elijaEliminarAWSCloudFormationPila.

4. Para confirmar la eliminación de la pila seleccionada, elijaSí.

Si la eliminación de la pila se realiza correctamente, el Toolkit for VS Code elimina el nombre de la piladeAWS CloudFormationlista enAWSExplorador de.

Ejecutar y depurar funciones de Lambda directamentedesde el códigoAl probar elAWS SAM, puede optar por ejecutar y depurar solo la función Lambda y excluir otros recursosque elAWS SAMdefine la plantilla de. Este enfoque implica el uso de la herramientaCodeLensparaidentificar los manejadores de funciones Lambda en el código fuente que puede invocar directamente.

Los controladores Lambda detectados por CodeLens dependen del lenguaje y el tiempo de ejecución queesté utilizando para su aplicación.

Idioma/tiempo de ejecución Criterios para identificar las funciones de Lambdamediante indicadores CodeLens

C# (dotnetcore2.1, 3.1; .NET 5.0) La función incluye las siguientes características:

• Es una función pública de una clase pública.• Tiene uno o dos parámetros. Con dos

parámetros, el segundo parámetro debeimplementar elILambdaContext.

• Tiene un*.csprojen su carpeta principal dentrode la carpeta del espacio de trabajo VS Code.

Laextensión ms-dotnettools.csharp(o cualquierextensión que proporcione símbolos de idiomapara C #) está instalada y habilitada.

JavaScript/TypeScript (Node.js 10.x, 12.x, 14.x) La función incluye las siguientes características:

• Es una función exportada con hasta tresparámetros.

• Tiene unpackage.jsonen su carpeta principaldentro de la carpeta del espacio de trabajo VSCode.

: (2.7, 3.6, 3.7, 3.8, 3.9) La función incluye las siguientes características:

• Es una función de nivel superior.• Tiene unrequirements.txten su carpeta

principal dentro de la carpeta del espacio detrabajo VS Code.

67

AWSToolkit for VS Code Guía del usuarioEjecutar y depurar funciones de

Lambda directamente desde el código

Idioma/tiempo de ejecución Criterios para identificar las funciones de Lambdamediante indicadores CodeLensLaextensión ms-python.python(o cualquierextensión que proporcione símbolos de idiomapara Python) está instalado y habilitado.

Java (8, 8.al2, 11) La función incluye las siguientes características:

• Es una función pública de una clase pública, noabstracta.

• Tiene uno, dos o tres parámetros:• Un parámetro: El parámetro puede ser

cualquier cosa.• Dos parámetros: Los parámetros

deben serjava.io.InputStreamyajava.io.OutputStreamOel último parámetro debe seruncom.amazonaws.services.lambda.runtime.Context.

• Tres parámetros: Los parámetrosdeben serjava.io.InputStreamyajava.io.OutputStreamYel último parámetro debe seruncom.amazonaws.services.lambda.runtime.Context.

• Tiene unbuild.gradle(Gradle)opom.xml(Maven) en su carpeta principal dentrode la carpeta del espacio de trabajo VS Code.

Laextensión redhat.java(o cualquier extensión queproporcione símbolos de idioma para Java) estáinstalado y habilitado. Esta extensión requiere Java11, independientemente del tiempo de ejecuciónde Java que esté utilizando.

Lavscjava.vscode-java-debug(o cualquierextensión que proporcione un depurador de Java)está instalada y habilitada.

Ir (1.x) La función incluye las siguientes características:

• Es una función de nivel superior.• Se necesitan entre 0 y 2 argumentos. Si hay

dos argumentos, el primero debe implementarcontext.Context.

• Devuelve entre 0 y 2 argumentos. Si hay másde 0 argumentos, el último argumento debeimplementarerror.

• Tiene ungo.moddentro de la carpeta de espaciode trabajo VS Code.

Laextensión golang.goestá instalado, configurado yhabilitado.

68

AWSToolkit for VS Code Guía del usuarioEjecución y depuración de recursos

locales de Amazon API Gateway

Para ejecutar y depurar una aplicación sin servidor directamente desde el código de la aplicación

1. Para ver los archivos de la aplicación en el Explorador de archivos de código VS, elijaVista,Exploradorde.

2. En la carpeta de la aplicación (por ejemplo,mi-sample-app), expanda la carpeta de funciones (en estecaso,hello-world) y abra elapp.jsfile.

3. En el indicador CodeLens que identifica un manejador de funciones Lambda elegible, elijaAdd DebugConfiguration.

4. En el navegadorPaleta de comandos del, seleccione el tiempo de ejecución en el queAWS SAMseejecutará.

5. En el editor para ellaunch.json, edite o confirme los valores de las siguientes propiedades deconfiguración:

• "name"— Introduzca un nombre fácil de leer para que aparezca en el cuadro dediálogoConfiguraciónen el campo desplegableEjecución devista.

• "target"— Asegúrese de que el valor es"code"para que se invoque directamente un controladorde funciones Lambda.

• "lambdaHandler"Escriba el nombre del método dentro de su código al que Lambda llamapara invocar su función. Por ejemplo, para aplicaciones en JavaScript, el valor predeterminadoesapp.lambdaHandler.

• "projectRoot"Escriba la ruta al archivo de la aplicación que contiene la función Lambda.• "runtime"— Introduzca o confirme un tiempo de ejecución válido para el entorno de ejecución de

Lambda, por ejemplo,"nodejs.12x".• "payload"Elija una de las siguientes opciones para definir la carga de evento que desea

proporcionar a la función Lambda como entrada:• "json"Pares clave-valor con formato JSON que definen la carga de evento.• "path": ruta al archivo que se utiliza como carga de eventos.

En el ejemplo siguiente, el campo"json"define la carga útil.

Para obtener más información acerca de estas y otras entradas de lalaunch.json,consulteOpciones de configuración para depurar aplicaciones sin servidor (p. 72).

6.Si está satisfecho con la configuración de depuración, para iniciar la depuración, elija la flecha dereproducción verde junto aRUN.

Cuando se inician las sesiones de depuración, elCONSOLA DE DEPURACIÓNmuestra la salidade depuración y muestra los valores que devuelve la función Lambda. (Al Depuración deAWSSAMaplicaciones,AWSConjunto de herramientasse selecciona comoSalidacanal en elSalidaPanel de.)

Ejecución y depuración de recursos locales deAmazon API GatewayPuede ejecutar o depurarAWS SAMRecursos locales de API Gateway, especificados entemplate.yaml,ejecutando una configuración de inicio de VS Code detype=aws-samconinvokeTarget.target=api.

Note

API Gateway admite dos tipos de API, REST y HTTP. Sin embargo, la característica API GatewayconAWS Toolkit for Visual Studio CodeCompatible solo con API REST. A veces, las API HTTP sedenominan «API de API Gateway V2».

69

AWSToolkit for VS Code Guía del usuarioEjecución y depuración de recursos

locales de Amazon API Gateway

Para ejecutar y depurar recursos de API Gateway locales

1. Elija uno de los siguientes enfoques para crear una configuración de lanzamiento para unAWSSAMRecurso de API Gateway:

• Opción 1: Visite el código fuente del controlador (archivo.js, .cs o .py) en suAWS SAM, coloque elcursor sobre el controlador Lambda y elija la opciónAñadir configuración de depuraciónCodeLens Acontinuación, en el menú, elija el elemento marcadoAPI Evento.

• Opción 2: Editarlaunch.jsonCree una configuración de lanzamiento utilizando la siguientesintaxis.

{ "type": "aws-sam", "request": "direct-invoke", "name": "myConfig", "invokeTarget": { "target": "api", "templatePath": "n12/template.yaml", "logicalId": "HelloWorldFunction" }, "api": { "path": "/hello", "httpMethod": "post", "payload": { "json": {} } }, "sam": {}, "aws": {}}

2. En el código VSEjecución de, elija la configuración de inicio (llamadamyConfigen el ejemplo anterior).3. (Opcional) Agregue puntos de interrupción al código del proyecto Lambda.4. TipoF5o elijaPlay (Reproducir)en laEjecución dePanel de5. En el panel de resultados, vea los resultados.

ConfigurationCuando utiliza elinvokeTarget.targetvalor de la propiedadapi, el Toolkit cambia la validación deconfiguración de inicio y el comportamiento para admitir unapi.

{ "type": "aws-sam", "request": "direct-invoke", "name": "myConfig", "invokeTarget": { "target": "api", "templatePath": "n12/template.yaml", "logicalId": "HelloWorldFunction" }, "api": { "path": "/hello", "httpMethod": "post", "payload": { "json": {} },

70

AWSToolkit for VS Code Guía del usuarioEjecución y depuración de recursos

locales de Amazon API Gateway

"querystring": "abc=def&qrs=tuv", "headers": { "cookie": "name=value; name2=value2; name3=value3" } }, "sam": {}, "aws": {}}

Reemplace los valores del ejemplo de la siguiente manera:

invokeStarget.logicaID

Un recurso de API.path

La ruta de la API que solicita la configuración de inicio, por ejemplo,"path": "/hello".

Debe ser una ruta de API válida resuelta desde eltemplate.yamlespecificadoporinvokeTarget.templatePath.

httpMethod

Uno de los siguientes verbos: «delete», «get», «head», «options», «patch», «post», «put».payload

La carga útil JSON (cuerpo HTTP) para enviar en la solicitud, con la misma estructura y reglas queellambda.payload.

payload.pathapunta a un archivo que contiene la carga JSON.

payload.jsonespecifica una carga JSON en línea.headers

Mapa opcional de pares nombre-valor, que se utiliza para especificar los encabezados HTTP quedesea incluir en la solicitud, tal y como se muestra en el siguiente ejemplo.

"headers": { "accept-encoding": "deflate, gzip;q=1.0, *;q=0.5", "accept-language": "fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5", "cookie": "name=value; name2=value2; name3=value3", "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Safari/537.36",}

querystring

Cadena opcional que establece la propiedadquerystringde la solicitud, porejemplo,"querystring": "abc=def&ghi=jkl".

aws

¿Cómo?AWSSe proporciona información sobre la conexión. Para obtener más información, consultelaAWSpropiedades de conexión («aws»)En la tabla deOpciones de configuración para depuraraplicaciones sin servidor (p. 72)sección.

sam sam sam

¿Cómo se debeAWS SAMLa CLI crea la aplicación. Para obtener más información, consultelaAWSPropiedades de SAM CLI («sam»)En la tabla deOpciones de configuración para depuraraplicaciones sin servidor (p. 72)sección.

71

AWSToolkit for VS Code Guía del usuarioOpciones de configuración paradepurar aplicaciones sin servidor

Opciones de configuración para depurar aplicacionessin servidorAl abrir el cuadro de diálogolaunch.jsonpara editar configuraciones de depuración, puede usar el códigoVSIntelliSensepara ver y completar automáticamente las propiedades válidas. Para activar IntelliSense enel editor, pulseCtrl+Barra espaciadora.

IntelliSense le permite encontrar y definir propiedades para invocar las funciones de Lambda directamenteo con elAWS SAMplantilla de. También puede definir propiedades para"lambda"(cómo se ejecuta lafunción),"sam"(¿Cómo se debeAWS SAMCLI construye la aplicación), y"aws"(AWSSe proporcionainformación sobre la conexión).

AWS SAM: invocación directa del controlador Lambda/invocación de Lambda basada en plantillas

Propiedad Descripción

type Especifica qué extensión administra la configuración de inicio.Siempre se establece enaws-sampara usarAWS SAMCLI paracompilar y depurar localmente.

name Especifica un nombre fácil de leer para que aparezca en el cuadro dediálogoConfiguración de lanzamiento de depuraciónlista de.

request Especifica el tipo de configuraciónque se realizará mediante laextensión designada (aws-sam). Siempre se establece endirect-invokePara iniciar la función de Lambda.

invokeTarget Especifica el punto de entrada para invocar el recurso.

Para invocar directamente la función Lambda, establezca valorespara los siguientesinvokeTargetCampos:

• target— Establece encode.• lambdaHandler— El nombre del controlador de funciones de

Lambda a invocar.• projectRoot— La ruta del archivo de aplicación que contiene el

controlador de funciones Lambda.

Para invocar los recursos de Lambda con elAWS SAM, establezcalos valores para la siguienteinvokeTargetCampos:

• target— Establece entemplate.

72

AWSToolkit for VS Code Guía del usuarioOpciones de configuración paradepurar aplicaciones sin servidor

Propiedad Descripción• templatePath— La ruta a laAWS SAMarchivo de plantilla de.• logicalId— El nombre de recurso

deAWS::Lambda::FunctionorAWS::Serverless::FunctionParainvocar. Puede encontrar el nombre del recurso en elAWSSAMplantilla de. Tenga en cuenta que el campo AWS Toolkitreconoce implícitamente funciones definidas conPackageType:Imageen laAWS SAMcomoBasado en imágenesFuncionesde Lambda. Para obtener más información, consultePaquetesde implementación de Lambdaen laAWS LambdaGuía paradesarrolladores.

Lambda"lambda") propiedades

Propiedad Descripción

environmentVariables Pasa los parámetros operativos a la función de Lambda. Porejemplo, si está escribiendo en un bucket de Amazon S3, en lugar decodificar de forma rígida el nombre del bucket, configúrelo como unavariable de entorno.

Note

Al especificar variables de entorno para una aplicaciónsin servidor, debe agregar configuraciones tanto aAWSSAM(template.yaml) y ellaunch.jsonfile.Ejemplo de formato para una variable de entorno en elAWSSAM: Template

Resources: HelloWorldFunction: Type: AWS::Serverless::Function Properties: CodeUri: hello-world/ Handler: app.lambdaHandlerN10 Runtime: nodejs10.x Environment: Variables: SAMPLE1: Default Sample 1 Value

Ejemplo de formato para una variable de entorno enellaunch.jsonfile:

"environmentVariables": { "SAMPLE1": "My sample 1 value" }

payload Proporciona dos opciones para la carga de evento que proporciona ala función Lambda como entrada.

• "json"Pares clave-valor con formato JSON que definen la cargade evento.

• "path": ruta al archivo que se utiliza como carga de eventos.

memoryMB Especifica megabytes (MB) de memoria proporcionados paraejecutar una función Lambda invocada.

73

AWSToolkit for VS Code Guía del usuarioOpciones de configuración paradepurar aplicaciones sin servidor

Propiedad Descripción

runtime Especifica el tiempo de ejecución que utiliza la función Lambda.Para obtener más información, consulteAWS LambdaTiempos deejecución de ..

timeoutSec Establece el tiempo permitido, en segundos, antes de que se agotela sesión de depuración.

pathMappings Especifica dónde está el código local en relación con dónde seejecuta en el contenedor.

De forma predeterminada, el Toolkit for VS CodeestablecelocalRoota la raíz de código de la función Lambda en elespacio de trabajo local, yremoteRootDe a/var/task, que es eldirectorio de trabajo predeterminado para el código que se ejecutaen Lambda. Si el directorio de trabajo se cambia en Dockerfile o conelWorkingDirectoryparámetro en el campoAWS CloudFormation,al menos un archivopathMappingdebe especificarse para que eldepurador pueda asignar correctamente los puntos de interrupciónestablecidos localmente al código que se ejecuta en el contenedorLambda.

Ejemplo de formato parapathMappingsen lalaunch.jsonfile:

"pathMappings": [ { "localRoot": "${workspaceFolder}/sam-app/HelloWorldFunction", "remoteRoot": "/var/task" }]

Advertencias:

• Para las funciones Lambda basadas en imágenes de.NET,elremoteRootdebe ser el directorio de compilación.

• Para las funciones Lambda basadas en Node.js, sólo puedeespecificar una única entrada de asignación de ruta.

El Toolkit for VS Code utiliza laAWS SAMCLI para compilar y depurar aplicaciones sin servidor localmente.Puede configurar el comportamiento deAWS SAMcomandos CLI que utilizan las propiedades dela"sam"configuración en ellaunch.jsonfile.

AWS SAMCLI ("sam") propiedades

Propiedad Descripción Valor predeterminado

buildArguments Configura el modo en que elsambuildconstruye su código fuenteLambda. Para ver las opcionesde compilación, consultesambuilden laAWS ServerlessApplication ModelGuía paradesarrolladores.

Cadena vacía

74

AWSToolkit for VS Code Guía del usuarioOpciones de configuración paradepurar aplicaciones sin servidor

Propiedad Descripción Valor predeterminado

containerBuild Indica si se debe construir sufunción dentro de un contenedorDocker similar a Lambda.

false

dockerNetwork Especifica el nombre o ID deuna red Docker existente queel LambdaLos contenedoresDocker deben conectarsea, junto con la red en modopuente predeterminada. Si nose especifica, los contenedoresLambda se conectan solo a lared Docker en modo puentepredeterminada.

Cadena vacía

localArguments Especifica argumentos deinvocación locales adicionales.

Cadena vacía

skipNewImageCheck Especifica si el comando debeomitir la eliminación de la últimaimagen de Docker para el tiempode ejecución de Lambda.

false

template Personalización de suAWSSAMutilizando parámetros paraintroducir valores de cliente.Para obtener más información,consulte Parámetros en laGuía del usuario de AWSCloudFormation .

"parameters":{}

AWSconexión ("aws") propiedades

Propiedad Descripción Valor predeterminado

credentials Selecciona un perfilespecífico (porejemplo,profile:default) desu archivo de credenciales paraobtenerAWSCredenciales de .

LaAWScredenciales quesuCompartidoAWSarchivode configuración ocompartidoAWSarchivo decredenciales (p. 5)Proporcione alToolkit for VS Code.

region EstableceAWSEn la región delservicio (por ejemplo, us-east-1).

El valor de tiempo de esperapredeterminado deAWSRegiónasociada al perfil de credencialesactivas.

Ejemplo: Configuración de lanzamiento de la plantillaA continuación se muestra un ejemplo de archivo de configuración de lanzamiento paraAWS SAMdestinode plantilla:

{ "configurations": [

75

AWSToolkit for VS Code Guía del usuarioSolución de problemas

{ "type": "aws-sam", "request": "direct-invoke", "name": "my-example:HelloWorldFunction", "invokeTarget": { "target": "template", "templatePath": "template.yaml", "logicalId": "HelloWorldFunction" }, "lambda": { "payload": {}, "environmentVariables": {} } } ]}

Ejemplo: Configuración de lanzamiento de códigoAquí hay un ejemplo de archivo de configuración de lanzamiento para un objetivo de función Lambda:

{ "configurations": [ { "type": "aws-sam", "request": "direct-invoke", "name": "my-example:app.lambda_handler (python3.7)", "invokeTarget": { "target": "code", "projectRoot": "hello_world", "lambdaHandler": "app.lambda_handler" }, "lambda": { "runtime": "python3.7", "payload": {}, "environmentVariables": {} } } ]}

Solución de problemas de aplicaciones sin servidorEn este tema se detallan los errores comunes que podría detectar al crear aplicaciones sin servidor con elToolkit for VS Code y cómo resolverlos.

Temas• ¿Cómo puedo usar un samconfig.toml con una configuración de inicio SAM? (p. 77)• Error: «RuntimeError: El contenedor no existe» (p. 77)• Error: «Docker.errors.apiError: 500 Error de servidor... Has alcanzado tu límite de tasa de

atracción». (p. 77)• Error: «Error de servidor 500: Montaje C:\Users\...» (p. 77)• Usando WSL, webviews (por ejemplo, el «Invocar enAWS«forma) se rompen (p. 77)• Depurar una aplicación TypeScript, pero los puntos de interrupción no funcionan (p. 78)

76

AWSToolkit for VS Code Guía del usuarioSolución de problemas

¿Cómo puedo usar un samconfig.toml con una configuración deinicio SAM?Especifique la ubicación de su CLI de SAMsamconfig.tomlconfigurando el--config-fileargumentoen el camposam.localArgumentsde la configuración de lanzamiento. Por ejemplo, si el archivosamconfig.toml se encuentra en el nivel superior del espacio de trabajo:

"sam": { "localArguments": ["--config-file", "${workspaceFolder}/samconfig.toml"],}

Error: «RuntimeError: El contenedor no existe»Lasam buildpuede mostrar este error si el sistema no tiene suficiente espacio en disco para elcontenedor Docker. Si el almacenamiento del sistema solo tiene 1-2 GB de espacio disponible,sambuildpuede fallar durante el procesamiento, incluso si el almacenamiento del sistema no estácompletamente lleno antes de que se inicie la compilación. Para obtener más información, consulteEsteproblema de GitHub.

Error: «Docker.errors.apiError: 500 Error de servidor... Hasalcanzado tu límite de tasa de atracción».Docker Hub limita las solicitudes que los usuarios anónimos pueden realizar. Si su sistema alcanza ellímite, Docker falla y este error aparece en la vista OUTPUT de VS Code:

docker.errors.APIError: 500 Server Error: Internal Server Error ("toomanyrequests: You havereached your pull rate limit. You may increase the limit by authenticating and upgrading:https://www.docker.com/increase-rate-limit")

Asegúrese de que suservicio Docker de sistemaSe ha autenticado con sus credenciales de Docker Hub.

Error: «Error de servidor 500: Montaje C:\Users\...»Los usuarios de Windows pueden ver este error de montaje de Docker al depurarAWS SAMaplicaciones:

Fetching lambci/lambda:nodejs10.x Docker container image......2019-07-12 13:36:58 Mounting C:\Users\<username>\AppData\Local\Temp\ ... as /var/task:ro,delegated inside runtime containerTraceback (most recent call last):...requests.exceptions.HTTPError: 500 Server Error: Internal Server Error ...

Intente actualizar las credenciales de las unidades compartidas (en la configuración de Docker).

Usando WSL, webviews (por ejemplo, el «Invocar enAWS«forma)se rompenEste es un problema conocido de VS Code para los usuarios de Cisco VPN. Para obtener másinformación, consulteEste problema de GitHub.

Se sugiere una solución alternativa eneste problema de seguimiento de WSL.

77

AWSToolkit for VS Code Guía del usuarioSolución de problemas

Depurar una aplicación TypeScript, pero los puntos deinterrupción no funcionanEsto sucederá si no hay un mapa de origen para vincular el archivo JavaScript compilado al archivoTypeScript de origen. Para corregirlo, abra eltsconfig.jsony asegúrese de que la opción y el valorsiguientes están establecidos:"inlineSourceMap": true.

78

AWSToolkit for VS Code Guía del usuarioProtección de los datos

Seguridad de AWS Toolkit for VSCode

La seguridad en la nube de Amazon Web Services (AWS) es la máxima prioridad. Como cliente deAWS, se beneficia de una arquitectura de red y un centro de datos que se han diseñado para satisfacerlos requisitos de seguridad de las organizaciones más exigentes. La seguridad es una responsabilidadcompartida entre AWS y usted. En el modelo de responsabilidad compartida, se habla de «seguridad de lanube» y «seguridad en la nube»:

Seguridad de la nube: AWS es responsable de proteger la infraestructura que ejecuta todos los serviciosofrecidos en la nube de AWS y proporcionar servicios que usted puede utilizar de forma segura. Nuestraresponsabilidad en torno a la seguridad es la mayor prioridad en AWS y auditores externos prueban yverifican la eficacia de nuestra seguridad con frecuencia como parte de los programas de conformidad deAWS.

Seguridad en la nube: su responsabilidad viene determinada por el servicio de AWS que usa y otrosfactores, como la confidencialidad de los datos, los requisitos de la organización y las normas yreglamentos aplicables.

EsteAWSproducto o servicio sigue elModelo de responsabilidad compartidaA través de la específicaAmazon Web Services (AWS) que soporta. Para obtener información sobre la seguridad de los serviciosde AWS, consulte la página de documentación sobre la seguridad de los servicios de AWS y los serviciosde AWS sujetos a las medidas de conformidad de AWS de cada programa de conformidad.

Temas• Protección de datos en AWS Toolkit for VS Code (p. 79)• Identity and Access Management paraAWSProducto o servicio (p. 80)• Registro y monitorización en AWS Toolkit for VS Code (p. 80)• Validación de la conformidad paraAWSProducto o servicio (p. 81)• Resiliencia paraAWSProducto o servicio (p. 81)• Seguridad de la infraestructura paraAWSProducto o servicio (p. 82)• Configuración y análisis de vulnerabilidades en AWS Toolkit for VS Code (p. 82)

Protección de datos en AWS Toolkit for VS CodeLaAWS Modelo de responsabilidad compartidase aplica a la protección de datos en AWS Toolkit for VSCode. Como se describe en este modelo, AWS es responsable de proteger la infraestructura global queejecuta toda la Nube de AWS . Usted es responsable de mantener el control sobre el contenido alojado enesta infraestructura. Este contenido incluye la configuración de seguridad y las tareas de administraciónde los servicios de AWS que utiliza usted. Para obtener más información acerca de la privacidad de datos,consulte las Preguntas frecuentes sobre privacidad de datos. Para obtener información acerca de laprotección de datos en Europa, consulte la publicación de blog The AWS Shared Responsability Model andGDPR en el Blog de seguridad de AWS.

Para fines de protección de datos, recomendamos proteger Cuenta de AWS y configurar cuentas deusuario individuales conAWS Identity and Access Management(IAM). De esta manera, solo se otorgana cada usuario los permisos necesarios para cumplir con sus obligaciones laborales. También lerecomendamos proteger sus datos de las siguientes formas:

79

AWSToolkit for VS Code Guía del usuarioIdentity and Access Management

• Utilice Multi-Factor Authentication (MFA) con cada cuenta.• Utilice SSL/TLS para comunicarse con los recursos de AWS. Le recomendamos TLS 1.2 o una versión

posterior.• Configure la API y el registro de actividad de los usuarios con AWS CloudTrail.• Utilice las soluciones de cifrado de AWS, junto con todos los controles de seguridad predeterminados de

los servicios de AWS.• Utilice avanzados servicios de seguridad administrados, como Amazon Macie, que le ayuden a detectar

y proteger los datos personales almacenados en Amazon S3.• Si necesita módulos criptográficos validados FIPS 140-2 cuando accede a AWS a través de una interfaz

de línea de comandos o una API, utilice un punto de enlace de FIPS. Para obtener más informaciónacerca de los puntos de enlace de FIPS disponibles, consulte Estándar de procesamiento de lainformación federal (FIPS) 140-2.

Le recomendamos encarecidamente que nunca introduzca información de identificación confidencial,como, por ejemplo, direcciones de email de sus clientes, en etiquetas o en los campos de formato libre,como el campo Name (Nombre). Esto incluye cuando trabaje con Toolkit for VS Code u otroAWSutilizandola consola, API,AWS CLI, o bienAWSSDK. Los datos que ingresa en etiquetas o campos de formatolibre utilizados para los nombres se pueden utilizar para los registros de facturación o diagnóstico.Si proporciona una URL a un servidor externo, le recomendamos encarecidamente que no incluyainformación de credenciales en la URL para validar la solicitud para ese servidor.

Identity and Access ManagementparaAWSProducto o servicio

AWS Identity and Access Management(IAM) es un Amazon Web Services (AWS) que ayuda aladministrador a controlar de forma segura el acceso aAWSde AWS. Los administradores de IAM controlanquién puedeautenticado(iniciado sesión) yAutorizado(tienen permisos) para usar recursos enAWSServiciosde . IAM es un servicio de AWS que puede utilizar sin cargo adicional.

Para usar esteAWSproducto o servicio para accederAWS, necesita unaAWSCuenta de yAWSCredencialesde . Para aumentar la seguridad de su cuenta de AWS, le recomendamos que utilice un usuario de IAM ala hora de proporcionar credenciales de acceso en lugar de usar las credenciales de su cuenta de AWS.

Para obtener más información acerca de cómo trabajar con IAM, consulteAWS Identity and AccessManagement.

Para obtener información general acerca del usuario de IAM y por qué es importante para la seguridad desu cuenta, consulteAWSCredenciales de seguridad deen laReferencia general de Amazon Web Services.

EsteAWSproducto o servicio sigue elModelo de responsabilidad compartidaA través de la específicaAmazon Web Services (AWS) que soporta. Para obtener información sobre la seguridad de los serviciosde AWS, consulte la página de documentación sobre la seguridad de los servicios de AWS y los serviciosde AWS sujetos a las medidas de conformidad de AWS de cada programa de conformidad.

Registro y monitorización en AWS Toolkit for VSCode

EsteAWSProporciona el estado y los resultados enSALIDAPestaña yCONSOLA DEDEPURACIÓNPestaña. También puede ver los registros de esta actividad.

80

AWSToolkit for VS Code Guía del usuarioValidación de la conformidad

Para ver los registros de Toolkit for VS Code

1. Abra View (Ver), Command Palette (Paleta de comandos).2. Tipo»AWS«en el cuadro de búsqueda y elijaAWS: VistaAWSRegistros del Conjunto de herramientas.

Validación de la conformidad paraAWSProducto oservicio

EsteAWSproducto o servicio sigue elModelo de responsabilidad compartidaA través de la específicaAmazon Web Services (AWS) que soporta. Para obtener información sobre la seguridad de los serviciosde AWS, consulte la página de documentación sobre la seguridad de los servicios de AWS y los serviciosde AWS sujetos a las medidas de conformidad de AWS de cada programa de conformidad.

Hay auditores externos que evalúan la seguridad y la conformidad de los servicios de AWS en diferentesprogramas de conformidad de AWS. Entre estos se incluyen SOC, PCI, FedRAMP, HIPAA y otros. AWSproporciona una lista actualizada con frecuencia de los servicios de AWS adscritos al ámbito de programasde conformidad específicos en Servicios de AWS en el ámbito del programa de conformidad.

Los informes de auditoría de terceros están disponibles para su descarga utilizando AWS Artifact. Paraobtener más información, consulte Descarga de informes en AWS Artifact.

Para obtener más información acerca de los programas de conformidad de AWS, consulte Programas deconformidad de AWS.

Su responsabilidad de cumplimiento al usar esteAWSproducto o servicio para acceder aAWSse determinaen función de la sensibilidad de los datos, los objetivos de conformidad de su organización, así como de lalegislación y los reglamentos aplicables. Si su uso de AWS está sujeto a estándares de conformidad comoHIPAA, PCI o FedRAMP, AWS cuenta con recursos que le servirán de ayuda:

• Guías de inicio rápido de seguridad y conformidad: guías de implementación que ofrecenconsideraciones sobre la arquitectura y los pasos para implementar entornos de referencia centrados enla seguridad y la conformidad de AWS.

• Documento técnico de Architecting for HIPAA Security and Compliance— Un documento técnico quedescribe cómo las empresas pueden usarAWSPara crear aplicaciones que se ajusten al estándarHIPAA.

• AWSRecursos de conformidad: un conjunto de manuales y guías que podría aplicarse a su sector yubicación.

• AWS Config: un servicio que evalúa en qué medida las configuraciones de los recursos cumplen lasprácticas internas, las directrices del sector y la normativa.

• AWS Security Hub: un servicio que ofrece una vista integral de su estado de seguridad en AWSque lo ayuda a comprobar la conformidad con las normas del sector de seguridad y las prácticasrecomendadas.

Resiliencia paraAWSProducto o servicioLa infraestructura global de Amazon Web Services (AWS) se basa en regiones y zonas de disponibilidadde AWS.

Las regiones de AWS proporcionan varias zonas de disponibilidad físicamente independientes y aisladasque se encuentran conectadas mediante redes con un alto nivel de rendimiento y redundancia, además debaja latencia.

81

AWSToolkit for VS Code Guía del usuarioSeguridad de la infraestructura

Con las zonas de disponibilidad, puede diseñar y utilizar aplicaciones y bases de datos que realizanuna conmutación por error automática entre zonas de disponibilidad sin interrupciones. Las zonas dedisponibilidad tienen una mayor disponibilidad, tolerancia a errores y escalabilidad que las infraestructurastradicionales de centros de datos únicos o múltiples.

Para obtener más información sobre zonas de disponibilidad y las regiones de AWS, consulteInfraestructura global de AWS.

EsteAWSproducto o servicio sigue elModelo de responsabilidad compartidaA través de la específicaAmazon Web Services (AWS) que soporta. Para obtener información sobre la seguridad de los serviciosde AWS, consulte la página de documentación sobre la seguridad de los servicios de AWS y los serviciosde AWS sujetos a las medidas de conformidad de AWS de cada programa de conformidad.

Seguridad de la infraestructura paraAWSProducto oservicio

EsteAWSproducto o servicio sigue elModelo de responsabilidad compartidaA través de la específicaAmazon Web Services (AWS) que soporta. Para obtener información sobre la seguridad de los serviciosde AWS, consulte la página de documentación sobre la seguridad de los servicios de AWS y los serviciosde AWS sujetos a las medidas de conformidad de AWS de cada programa de conformidad.

Configuración y análisis de vulnerabilidades enAWS Toolkit for VS Code

EsteAWSproducto o servicio se libera a laMarketplace de Visual StudioA medida que se desarrollannuevas características o correcciones. Estas actualizaciones a veces incluyen actualizaciones deseguridad, por lo que es importante mantener actualizado Toolkit for VS Code.

Para comprobar que las actualizaciones automáticas de las extensiones estén habilitadas:

1. Abra la ventana Settings (Configuración) eligiendo File (Archivo), Preferences (Preferencias), Settings(Configuración).

2. Expanda Features (Características) y elija Extensions (Extensiones).3. Ajuste la configuración de su entorno.

Si decide deshabilitar las actualizaciones automáticas de extensiones, asegúrese de comprobar si hayactualizaciones de Toolkit for VS Code a intervalos adecuados para su entorno.

82

AWSToolkit for VS Code Guía del usuario

Historial de revisión de la Guía delusuario de AWS Toolkit for VisualStudio Code

Última actualización importante de la documentación: 11 de agosto de 2021

En la siguiente tabla se describen los cambios importantes en cada versión del AWS Toolkit for VisualStudio Code . Para obtener notificaciones sobre las actualizaciones de esta documentación, puedesuscribirse a una fuente RSS.

update-history-change update-history-description update-history-date

Compatibilidad con AppRunner (p. 25)

Se ha agregado soporte paraAWS App Runner para AWSToolkit for Visual Studio Code .

11 de agosto de 2021

Funciones de DepuraciónGo (p. 64)

Agregado soporte para ladepuración de funciones Golocales.

10 de mayo de 2021

Depuración de funciones deJava (p. 64)

Agregado soporte para ladepuración de funciones Javalocales.

22 de abril de 2021

Compatibilidad con YAML paraAWS Step Functions (p. 51)

Se ha agregado compatibilidadcon YAML paraAWS StepFunctions.

4 de marzo de 2021

Depuración de recursos deAmazon API Gateway (p. 62)

Se ha añadido compatibilidadcon la depuración de recursoslocales de Amazon API Gateway.

1 de diciembre de 2020

Amazon API Gateway (p. 25) Se ha agregado compatibilidadcon Amazon API Gateway.

1 de diciembre de 2020

AWS Serverless Application (p. 62)

Añadido soporte para imágenesde contenedor Lambda conaplicaciones sin servidor.

1 de diciembre de 2020

AWS Systems ManagerCompatibilidad con (p. 47)

Se ha agregado compatibilidadpara los documentos deAutomatización de SystemManager

30 de septiembre de 2020

Registros de CloudWatch (p. 32) Se ha agregado compatibilidadpara CloudWatch Logs.

24 de agosto de 2020

Amazon S3 (p. 43) Se ha agregado compatibilidadpara Amazon S3.

30 de julio de 2020

AWS Step FunctionsCompatibilidad con (p. 51)

Se agregó compatibilidad conAWS Step Functions.

31 de marzo de 2020

83

AWSToolkit for VS Code Guía del usuario

Contenido de seguridad (p. 79) Se ha añadido contenido deseguridad.

6 de febrero de 2020

Trabajo con esquemas deAmazon EventBridge (p. 35)

Se ha agregado compatibilidadcon esquemas de AmazonEventBridge

1 de diciembre de 2019

AWS CDK Explorer (p. 59) La versión preliminar deAWSCDKCaracterística Explorer.

25 de noviembre de 2019

Uso de un proceso decredenciales externo (p. 10)

Se agregó información sobreel uso de un proceso decredenciales externo paraobtenerAWSCredenciales de .

25 de septiembre de 2019

Uso de IntelliSense para archivosde definición de tareas (p. 58)

Se ha agregado compatibilidadcon IntelliSense para trabajar conarchivos de definición de tareasde Amazon ECS.

24 de septiembre de 2019

Guía del usuario del AWS Toolkitfor Visual Studio Code (p. 1)

Versión de disponibilidadgeneral.

11 de julio de 2019

Guía del usuario del AWS Toolkitfor Visual Studio Code (p. 1)

Se actualizó la estructura deldocumento para mayor claridad yfacilidad de uso.

3 de julio de 2019

Instalación deAWSToolkit for VSCode (p. 2)

Se agregó información sobrela instalación de los SDK delenguaje para admitir variascadenas de herramientas.

12 de junio de 2019

Configurar la cadena deherramientas (p. 16)

Se ha añadido informaciónsobre la configuración de variascadenas de herramientas.

12 de junio de 2019

Versión inicial (p. 83) Versión inicial de la Guía delusuario del AWS Toolkit forVisual Studio Code .

28 de marzo de 2019

84

AWSToolkit for VS Code Guía del usuario

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

lxxxv