Esta es la guía para AWS CDK desarrolladores de la versión 2. La CDK versión anterior entró en mantenimiento el 1 de junio de 2022 y finalizó el soporte 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.
Uso del AWS CDK en Go
Go es un lenguaje de cliente totalmente compatible con AWS Cloud Development Kit (AWS CDK) y se lo considera estable. Para trabajar con el AWS CDK en Go se utilizan herramientas conocidas. La versión Go de AWS CDK incluso usa identificadores de tipo Go.
A diferencia de los otros lenguajes compatibles con CDK, Go no es un lenguaje de programación tradicional orientado a objetos. Este utiliza la composición, mientras que otros lenguajes suelen aprovechar la herencia. Hemos intentado emplear enfoques idiomáticos de Go en la medida de lo posible, sin embargo, existen aspectos en los que el CDK puede diferir.
En este tema se proporciona orientación para trabajar con el AWS CDK en Go. Consulte la publicación del blog sobre el anuncio
Temas
Introducción a Go
Para trabajar con el AWS CDK, debe tener una cuenta de AWS y credenciales, y haber instalado Node.js y el kit de herramientas de AWS CDK. Consulte Introducción al AWS CDK.
Los enlaces Go para el uso de AWS CDK de la cadena de herramientas Go
nota
Obsolescencia del lenguaje de terceros: la versión en otro lenguaje solo se admite hasta que el proveedor o la comunidad compartan su fecha de vida útil (EOL), y está sujeta a cambios con previo aviso.
Creación de un proyecto
Primero cree un nuevo proyecto AWS CDK, mediante la invocación de cdk init en un directorio vacío. Utilice la opción --language y especifique go:
mkdir my-project cd my-project cdk init app --language go
cdk init utiliza el nombre de la carpeta del proyecto para asignar un nombre a varios elementos del proyecto, incluidas las clases, las subcarpetas y los archivos. Los guiones del nombre de la carpeta se convierten en guiones bajos. Sin embargo, de lo contrario, el nombre debe seguir la forma de un identificador de Go; por ejemplo, no debe comenzar por un número ni contener espacios.
El proyecto resultante incluye una referencia al módulo principal de AWS CDK Go, github.com/aws/aws-cdk-go/awscdk/v2, en go.mod. Ejecute go
get para instalar este y otros módulos necesarios.
Gestión de los módulos de la Biblioteca de constructos de AWS
En la mayoría de los ejemplos y la documentación de AWS CDK, se suele utilizar la palabra “módulo” para referirse a los módulos de la Biblioteca de constructos de AWS, uno o más por servicio de AWS, lo que difiere del uso idiomático del término en Go. La Biblioteca de constructos de CDK se proporciona en un módulo Go junto con los módulos individuales de la biblioteca de constructos, los cuales admiten los distintos servicios de AWS, que se proporcionan como paquetes Go dentro de ese módulo.
Algunos servicios de la Biblioteca de constructos de AWS son compatibles con más de un módulo de la Biblioteca de constructos (paquete Go). Por ejemplo, Amazon Route 53 tiene tres módulos de la Biblioteca de constructos, además del paquete principal de awsroute53, denominados awsroute53patterns awsroute53resolver y awsroute53targets.
El paquete principal de AWS CDK, que necesitará en la mayoría de las aplicaciones AWS CDK, se importa en código Go como github.com/aws/aws-cdk-go/awscdk/v2. Los paquetes de los distintos servicios de la Biblioteca de constructos de AWS se encuentran en github.com/aws/aws-cdk-go/awscdk/v2. Por ejemplo, el espacio de nombres del módulo Amazon S3 es github.com/aws/aws-cdk-go/awscdk/v2/awss3.
import ( "github.com/aws/aws-cdk-go/awscdk/v2/awss3" // ... )
Una vez que haya importado los módulos de la Biblioteca de constructos (paquetes Go) para los servicios que desee usar en su aplicación, podrá acceder a las construcciones de ese módulo utilizando, por ejemplo, awss3.Bucket.
Administración de dependencias en Go
En Go, las versiones de las dependencias se definen en go.mod. El valor predeterminado go.mod es similar al que se muestra aquí.
module my-package go 1.16 require ( github.com/aws/aws-cdk-go/awscdk/v2 v2.16.0 github.com/aws/constructs-go/constructs/v10 v10.0.5 github.com/aws/jsii-runtime-go v1.29.0 )
Los nombres de los paquetes (módulos, en el lenguaje de Go) se especifican a través de una URL con el número de versión requerido adjunto. El sistema de módulos de Go no admite rangos de versiones.
Ejecute el comando go get para instalar todos los módulos necesarios y actualizarlos en go.mod. Para ver una lista de las actualizaciones disponibles para sus dependencias, ejecute go list -m -u all.
Modismos de AWS CDK en Go
Nombres de campos y métodos
Los nombres de campos y métodos utilizan minúsculas (likeThis) en TypeScript, el lenguaje de origen de CDK. En Go, estos siguen las convenciones de Go, al igual que las mayúsculas (LikeThis).
Limpieza
En su método main, use defer jsii.Close() para asegurarse de que la aplicación CDK se limpie sola.
Valores faltantes y conversión de punteros
En Go, los valores faltantes en objetos de AWS CDK, como las agrupaciones de propiedades, se representan mediante nil. Go no tiene tipos que acepten valores nulos; el único tipo que puede contener nil es un puntero. Por lo tanto, para permitir que los valores sean opcionales, todas las propiedades, argumentos y valores de retorno de CDK son punteros, incluso en el caso de los tipos primitivos. Esto se aplica tanto a los valores obligatorios como opcionales. Si un valor obligatorio se vuelve opcional, no será necesario cambiar el tipo de valor.
Al pasar valores o expresiones literales, utilice las siguientes funciones auxiliares para crear punteros a los valores.
-
jsii.String -
jsii.Number -
jsii.Bool -
jsii.Time
Para mantener la coherencia, recomendamos que utilice los punteros de forma similar cuando defina sus propios constructos, aunque pueda parecer más conveniente, por ejemplo, recibir constructos como una cadena en lugar de id como puntero a una cadena.
Cuando se trate de valores AWS CDK opcionales, incluidos los valores primitivos y de tipos complejos, debe probar los punteros de forma explícita para asegurarse de que no sean nil antes de hacer cualquier acción con ellos. Go no tiene “azúcar sintáctico” que ayude a gestionar los valores vacíos o faltantes, como ocurre en otros lenguajes. Sin embargo, se garantiza la existencia de los valores obligatorios en las agrupaciones de propiedades y estructuras similares (de lo contrario, los constructos no funcionan), por lo que no es necesario verificar nil en estos valores.
Constructos y accesorios
Los constructos, que representan uno o más recursos de AWS y sus atributos asociados, se presentan en Go como interfaces. Por ejemplo, awss3.Bucket es una interfaz. Cada constructo tiene una función de fábrica, como awss3.NewBucket, para devolver una estructura que implementa la interfaz correspondiente.
Todas las funciones de fábrica tienen tres argumentos: el scope en el que se define el constructo, su elemento principal en el árbol de constructos, un id y props, una agrupación de pares clave/valor que el constructo utiliza para configurar los recursos que crea. El patrón de la “agrupación de atributos” también se utiliza en otras partes del AWS CDK.
En Go, los accesorios se representan mediante un tipo de estructura específica para cada constructo. Por ejemplo, awss3.Bucket toma un argumento de tipo accesorio awss3.BucketProps. Usa una estructura literal para escribir argumentos de utilería.
var bucket = awss3.NewBucket(stack, jsii.String("amzn-s3-demo-bucket"), &awss3.BucketProps{ Versioned: jsii.Bool(true), })
Estructuras genéricas
En algunos lugares, AWS CDK utiliza matrices de JavaScript u objetos sin tipo como entrada a un método. (Consulte, por ejemplo, el método AWS CodeBuild de BuildSpec.fromObject()). En Go, estos objetos se representan como sectores y una interfaz vacía.
El CDK proporciona diversas funciones auxiliares, como jsii.Strings, para crear segmentos que contienen tipos primitivos.
jsii.Strings("One", "Two", "Three")
Desarrollo de constructos personalizados
En Go, suele ser más sencillo escribir un nuevo constructo que extender uno existente. En primer lugar, defina un nuevo tipo de estructura, incrustando de forma anónima uno o más tipos existentes en caso de que se desee una semántica similar a la de una extensión. Escriba métodos para cualquier funcionalidad nueva que vaya a agregar y los campos necesarios para almacenar los datos que necesite. Defina una interfaz de accesorios si su constructo la necesita. Por último, escriba una función de fábrica NewMyConstruct() para devolver una instancia de su constructo.
Si simplemente está cambiando algunos valores predeterminados en un constructo existente o agregando un comportamiento simple en esta instancia, no necesita toda esa configuración. En su lugar, escriba una función de fábrica que invoque a la función de fábrica del constructo que está “extendiendo”. En otros lenguajes de CDK, por ejemplo, puede crear un constructo TypedBucket que aplique el tipo de objetos de un bucket de Amazon S3 al anular el tipo s3.Bucket, y, en el inicializador del nuevo tipo, añada una política de bucket que solo permita agregar al bucket extensiones de nombre de archivo especificadas. En Go, es más fácil escribir simplemente un NewTypedBucket que devuelva un s3.Bucket (uso instanciado s3.NewBucket) a la que se haya agregado una política de bucket adecuada. No es necesario ningún tipo de constructo nuevo porque la funcionalidad ya está disponible en el constructo de bucket estándar; el nuevo simplemente proporciona una forma más sencilla de configurarlo.
Construir, sintetizar e implementar
AWS CDK compila automáticamente la aplicación antes de ejecutarla. Sin embargo, puede resultar útil compilar la aplicación manualmente para comprobar si hay errores y realizar pruebas. Para ello, ejecute go build en una línea de comandos solicitados desde el directorio raíz del proyecto.
Para ejecutar las pruebas que haya escrito, use go test en la línea de comandos solicitados.
