Esta es la guía para desarrolladores de AWS CDK v2. La primera versión del CDK pasó a la etapa de mantenimiento el 1.° de junio de 2022 y no cuenta con soporte desde el 1.° de junio de 2023.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Usar los recursos del registro público de AWS CloudFormation
El registro público de AWS CloudFormation le permite administrar extensiones, tanto públicas como privadas, como recursos, módulos y enlaces que puede utilizar en la cuenta de AWS. Con el constructo CfnResource, puede usar extensiones de recursos públicos en sus aplicaciones de AWS Cloud Development Kit (AWS CDK).
Para obtener más información acerca el registro público de AWS CloudFormation, consulte Uso del registro de AWS CloudFormation? en la guía del usuario de AWS CloudFormation.
Todas las extensiones públicas publicadas por AWS están disponibles para todas las cuentas de todas las regiones sin que tenga que hacer nada por su parte. Sin embargo, debe activar cada extensión de terceros que quiera usar en cada cuenta y región en la que quiera usarla.
nota
Si utiliza AWS CloudFormation con tipos de recursos de terceros, se le cobrarán cargos. Los cargos se basan en la cantidad de operaciones del controlador que ejecute al mes y en la duración de las operaciones del controlador. Consulte los precios de CloudFormation
Para obtener más información sobre las extensiones públicas, consulte Uso de extensiones públicas en CloudFormation en la Guía del usuario de AWS CloudFormation
Activar un recurso de terceros en su cuenta y región
Las extensiones publicadas por AWS no requieren activación. Siempre están disponibles en todas las cuentas y regiones. Puede activar una extensión de terceros a través de la consola de administración de AWS, con la interfaz de la línea de comandos de AWS o implementando un recurso de AWS CloudFormation especial.
- Para activar una extensión de terceros a través de la consola de administración de AWS o ver qué recursos están disponibles
-
-
Inicie sesión en la cuenta de AWS en la que quiere usar la extensión y, a continuación, cambie a la región en la que quiere usarla.
-
Diríjase a la consola de CloudFormation a través del menú Servicios.
-
Seleccione Extensiones públicas en la barra de navegación y, a continuación, active el botón de opción de terceros en Publicador. Aparece una lista de las extensiones públicas de terceros disponibles. (También puede elegir AWS para ver una lista de las extensiones públicas publicadas por AWS, aunque no necesita activarlas).
-
Explore la lista y busque la extensión que quiere activar. También puede buscarla y luego activar el botón de selección de la parte superior derecha de la tarjeta de la extensión.
-
Pulse el botón Activar en la parte superior de la lista para activar la extensión seleccionada. Aparece la página de Activación de la extensión.
-
En la página de Activación, puede anular el nombre predeterminado de la extensión y especificar una función de ejecución y una configuración de registro. También puede elegir si desea actualizar automáticamente la extensión cuando se lance una nueva versión. Cuando haya configurado estas opciones como desee, seleccione Activar la extensión en la parte inferior de la página.
-
- Para activar una extensión de terceros mediante la AWS CLI
-
-
Utilice el comando
activate-type. Sustituya el ARN del tipo personalizado que desee utilizar donde se indique.A continuación, se muestra un ejemplo:
aws cloudformation activate-type --public-type-arn <public_extension_ARN> --auto-update-activated
-
- Para activar una extensión de terceros mediante CloudFormation o CDK
-
-
Implemente un recurso de tipo
AWS::CloudFormation::TypeActivationy especifique las siguientes propiedades:-
TypeName: el nombre de la fase, por ejemplo,AWSQS::EKS::Cluster. -
MajorVersion: el número de versión principal de la extensión que desea. Omita si desea la versión más reciente. -
AutoUpdate: si se debe actualizar automáticamente esta extensión cuando el publicador lance una nueva versión secundaria. (Las actualizaciones de las versiones principales requieren cambiar la propiedadMajorVersionde forma explícita). -
ExecutionRoleArn: el ARN del rol de IAM bajo el que se ejecutará la extensión. -
LoggingConfig: la configuración de registro de la extensión.
El CDK puede implementar el recurso
TypeActivationmediante el constructoCfnResource. Esto se muestra para las extensiones reales en la siguiente sección. -
-
Agregar un recurso del registro público de AWS CloudFormation a su aplicación de CDK
Use el constructo CfnResource para incluir un recurso del registro público de AWS CloudFormation en su solicitud. Este constructo se encuentra en el módulo aws-cdk-lib de CDK.
Por ejemplo, supongamos que hay un recurso público con el nombre MY::S5::UltimateBucket que desea usar en su aplicación de AWS CDK. Este recurso tiene una propiedad: el nombre del bucket. La creación de instancias CfnResource correspondiente tiene el siguiente aspecto.
ejemplo
