Creación y actualización de los ajustes de la distribución de las imágenes de los contenedores

En esta sección se describe la creación y actualización de los ajustes de distribución de las imágenes de contenedores de Generador de Imágenes.

Cree ajustes de distribución para las imágenes de contenedor de Image Builder desde AWS CLI

Una configuración de distribución le permite especificar el nombre y la descripción de la imagen del contenedor de salida y replicar la imagen del contenedor en otras AWS regiones. También puede aplicar etiquetas independientes al recurso de configuración de distribución y a las imágenes del contenedor dentro de cada región.

1. Creación de un archivo JSON de entrada de la CLI

   Utilice su herramienta de edición de archivos favorita para crear un archivo JSON con las claves que se muestran en el siguiente ejemplo, además de valores que sean válidos para su entorno. En este ejemplo, se utiliza un archivo con el nombre create-container-distribution-configuration.json:

   {
   	"name": "distribution-configuration-name",
   	"description": "Distributes container image to Amazon ECR repository in two regions.",
   	"distributions": [
   	    {
   	        "region": "us-west-2",
   	        "containerDistributionConfiguration": {
   	            "description": "My test image.",
   	            "targetRepository": {
   	                "service": "ECR",
   	                "repositoryName": "testrepo"
   	            },
   	            "containerTags": ["west2", "image1"]
   	        }
   	    },
   	    {
   	        "region": "us-east-1",
   	        "containerDistributionConfiguration": {
   	            "description": "My test image.",
   	            "targetRepository": {
   	                "service": "ECR",
   	                "repositoryName": "testrepo"
   	            },
   	           "containerTags": ["east1", "imagedist"]
   	        }
   	    }
   	],
   	"tags": {
   	   "DistributionConfigurationTestTagKey1": "DistributionConfigurationTestTagValue1",
   	   "DistributionConfigurationTestTagKey2": "DistributionConfigurationTestTagValue2"
   	}
   }

2. Ejecute el siguiente comando utilizando el archivo que creó como entrada.

   aws imagebuilder create-distribution-configuration --cli-input-json file://create-container-distribution-configuration.json

   nota

   • Debe incluir la notación file:// al principio de la ruta del archivo JSON.

   • La ruta del archivo JSON debe seguir la convención apropiada para el sistema operativo base donde se está ejecutando el comando. Por ejemplo, Windows utiliza la barra diagonal inversa (\) para hacer referencia a la ruta del directorio y Linux usa la barra diagonal (/).

   Para obtener información más detallada, consulte create-distribution-configuration en la referencia de comandos de la AWS CLI .

Actualice la configuración de distribución de la imagen de su contenedor desde AWS CLI

El siguiente ejemplo muestra cómo utilizar el comando update-distribution-configuration para actualizar los ajustes de la distribución de la imagen de contenedor mediante la AWS CLI. También puede actualizar las etiquetas de las imágenes del contenedor en cada región.

1. Creación de un archivo JSON de entrada de la CLI

   Utilice su herramienta de edición de archivos favorita para crear un archivo JSON con las claves que se muestran en el siguiente ejemplo, además de valores que sean válidos para su entorno. En este ejemplo, se utiliza un archivo con el nombre update-container-distribution-configuration.json:

   {
       "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/update-container-distribution-configuration.json",
   	"description": "Distributes container image to Amazon ECR repository in two regions.",
   	"distributions": [
   	    {
   	        "region": "us-west-2",
   	        "containerDistributionConfiguration": {
   	            "description": "My test image.",
   	            "targetRepository": {
   	                "service": "ECR",
   	                "repositoryName": "testrepo"
   	            },
   	            "containerTags": ["west2", "image1"]
   	        }
   	    },
   	    {
   	        "region": "us-east-2",
   	        "containerDistributionConfiguration": {
   	            "description": "My test image.",
   	            "targetRepository": {
   	                "service": "ECR",
   	                "repositoryName": "testrepo"
   	            },
   	           "containerTags": ["east2", "imagedist"]
   	        }
   	    }
   	]
   }

2. Ejecute el siguiente comando utilizando el archivo que creó como entrada:

   aws imagebuilder update-distribution-configuration --cli-input-json file://update-container-distribution-configuration.json

   nota

   • Debe incluir la notación file:// al principio de la ruta del archivo JSON.

   • La ruta del archivo JSON debe seguir la convención apropiada para el sistema operativo base donde se está ejecutando el comando. Por ejemplo, Windows utiliza la barra diagonal inversa (\) para hacer referencia a la ruta del directorio y Linux usa la barra diagonal (/).

   Para obtener información más detallada, consulte update-distribution-configuration en la referencia de comandos de la AWS CLI . Para actualizar las etiquetas de su recurso de configuración de distribución, consulte la sección Etiquetar recursos.