Establecer o cambiar el modo de ejecución de la canalización

Puedes configurar el modo de ejecución de tu canalización para especificar cómo se gestionan las ejecuciones múltiples.

Para obtener más información sobre los modos de ejecución de la canalización, consulteCómo funcionan las ejecuciones de canalización.

importante

En el caso de las canalizaciones en modo PARALELO, al editar el modo de ejecución de la canalización como QUEUED o SUPERSEDED, el estado de la canalización no mostrará el estado actualizado como PARALELO. Para obtener más información, consulte Las canalizaciones que pasen del modo PARALELO mostrarán un modo de ejecución anterior.

importante

En el caso de las canalizaciones en modo paralelo, al editar el modo de ejecución de la canalización en COLA o REEMPLAZADO, la definición de canalización de la canalización en cada modo no se actualizará. Para obtener más información, consulte Las canalizaciones en modo PARALELO tienen una definición de canalización desactualizada si se editan al cambiar al modo EN COLA o REEMPLAZADO.

Consideraciones para ver los modos de ejecución

Hay que tener en cuenta la visualización de las canalizaciones en modos de ejecución específicos.

En los modos REEMPLAZADO y EN COLA, usa la vista de canalización para ver las ejecuciones en curso y haz clic en el ID de la ejecución para ver los detalles y el historial. En el modo paralelo, haga clic en el ID de ejecución para ver la ejecución en curso en la pestaña Visualización.

A continuación se muestra la vista del modo REEMPLAZADO en. CodePipeline

A continuación se muestra la vista del modo QUEUED en CodePipeline.

A continuación se muestra la vista del modo PARALELO en CodePipeline.

Consideraciones para cambiar entre modos de ejecución

Las siguientes son consideraciones para las canalizaciones a la hora de cambiar el modo de la canalización. Al cambiar de un modo de ejecución a otro en el modo de edición y, a continuación, guardar el cambio, es posible que determinadas vistas o estados se ajusten.

Por ejemplo, al cambiar del modo PARALELO al modo EN COLA o REEMPLAZADO, la ejecución iniciada en el modo PARALELO seguirá ejecutándose. Se pueden ver en la página del historial de ejecuciones. La vista de canalización mostrará la ejecución que se ejecutó anteriormente en modo COLA o REEMPLAZADA o en estado vacío en caso contrario.

Como otro ejemplo, si cambias del modo QUEUED o SUPERSEDED al modo PARALELO, ya no verás la página de vista y estado de la canalización. Para ver una ejecución en modo paralelo, utilice la pestaña de visualización de la página de detalles de la ejecución. Las ejecuciones iniciadas en modo REEMPLAZADO o EN COLA se cancelarán.

En la siguiente tabla se proporcionan más detalles.

Cambio de modo	Detalles de la ejecución pendiente y activa	Detalles del estado de la canalización
REEMPLAZADO A REEMPLAZADO O REEMPLAZADO A EN COLA	Las ejecuciones activas se cancelan cuando se completan las acciones en curso. Se cancelan las ejecuciones pendientes.	El estado de la canalización, como cancelado, se conserva entre la versión del primer modo y la del segundo modo.
PUESTO EN COLA PARA EN COLA O EN COLA PARA REEMPLAZADO	Las ejecuciones activas se cancelan cuando se completan las acciones en curso. Se cancelan las ejecuciones pendientes.	El estado de la canalización, como cancelado, se conserva entre la versión del primer modo y la del segundo modo.
PARALELO a PARALELO	Todas las ejecuciones pueden ejecutarse independientemente de las actualizaciones de las definiciones de canalización.	Vacío. El modo paralelo no tiene un estado de canalización.
REEMPLAZADO A PARALELO O EN COLA A PARALELO	Las ejecuciones activas se cancelan cuando se completan las acciones en curso. Se cancelan las ejecuciones pendientes.	Vacío. El modo paralelo no tiene un estado de canalización.

Configure o cambie el modo de ejecución de la canalización (consola)

Puedes usar la consola para configurar el modo de ejecución de la canalización.

1. Inicie sesión en la CodePipeline consola AWS Management Console y ábrala en http://console.aws.amazon.com/codesuite/codepipeline/home.

   Se muestran los nombres y el estado de todas las canalizaciones asociadas a tu AWS cuenta.

2. En Nombre, elija el nombre de la canalización que desea editar.

3. En la página de detalles de la canalización, elija Edit.

4. En la página de edición, seleccione Editar: propiedades de la canalización.

5. Elige el modo de tu canalización.

   • Reemplazado

   • En cola (se requiere una tubería de tipo V2)

   • Paralelo (se requiere una tubería de tipo V2)

6. En la página de edición, seleccione Listo.

Establecer el modo de ejecución de la canalización (CLI)

Para utilizar el AWS CLI modo de ejecución de la canalización, utilice el update-pipeline comando create-pipeline o.

1. Abra una sesión de terminal (Linux, macOS o Unix) o un símbolo del sistema (Windows) y ejecute el comando get-pipeline para copiar la estructura de canalización en un archivo JSON. Por ejemplo, para una canalización llamada MyFirstPipeline, escriba el siguiente comando:

   aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json

   Este comando no devuelve nada, pero el archivo creado debería aparecer en el directorio en el que se ejecutó el comando.

2. Abre el archivo JSON en cualquier editor de texto sin formato y modifica la estructura del archivo para que refleje el modo de ejecución de la canalización que deseas configurar, como QUEUED.

   "executionMode": "QUEUED"

   En el siguiente ejemplo, se muestra cómo configurar el modo de ejecución en QUEUED en un ejemplo de proceso con dos etapas.

   {
       "pipeline": {
           "name": "MyPipeline",
           "roleArn": "arn:aws:iam::111122223333:role/service-role/AWSCodePipelineServiceRole-us-east-1-dkpippe",
           "artifactStore": {
               "type": "S3",
               "location": "bucket"
           },
           "stages": [
               {
                   "name": "Source",
                   "actions": [
                       {
                           "name": "Source",
                           "actionTypeId": {
                               "category": "Source",
                               "owner": "AWS",
                               "provider": "CodeCommit",
                               "version": "1"
                           },
                           "runOrder": 1,
                           "configuration": {
                               "BranchName": "main",
                               "OutputArtifactFormat": "CODE_ZIP",
                               "PollForSourceChanges": "true",
                               "RepositoryName": "MyDemoRepo"
                           },
                           "outputArtifacts": [
                               {
                                   "name": "SourceArtifact"
                               }
                           ],
                           "inputArtifacts": [],
                           "region": "us-east-1",
                           "namespace": "SourceVariables"
                       }
                   ]
               },
               {
                   "name": "Build",
                   "actions": [
                       {
                           "name": "Build",
                           "actionTypeId": {
                               "category": "Build",
                               "owner": "AWS",
                               "provider": "CodeBuild",
                               "version": "1"
                           },
                           "runOrder": 1,
                           "configuration": {
                               "ProjectName": "MyBuildProject"
                           },
                           "outputArtifacts": [
                               {
                                   "name": "BuildArtifact"
                               }
                           ],
                           "inputArtifacts": [
                               {
                                   "name": "SourceArtifact"
                               }
                           ],
                           "region": "us-east-1",
                           "namespace": "BuildVariables"
                       }
                   ]
               }
           ],
           "version": 1,
           "executionMode": "QUEUED"
       }
   }

3. Si está trabajando con la estructura de la canalización recuperada mediante el comando get-pipeline, debe modificar la estructura del archivo JSON. Debe eliminar las líneas metadata del archivo para que el comando update-pipeline pueda utilizarlo. Quite la sección de la estructura de canalizaciones del archivo JSON (las líneas "metadata": { } y los campos "created", "pipelineARN" y "updated" que contenga).

   Por ejemplo, quite las siguientes líneas de la estructura:

   "metadata": {  
     "pipelineArn": "arn:aws:codepipeline:region:account-ID:pipeline-name",
     "created": "date",
     "updated": "date"
     }

   Guarde el archivo.

4. Para aplicar los cambios, ejecute el comando update-pipeline especificando el archivo JSON:

   importante

   Asegúrese de incluir file:// antes del nombre de archivo. Es obligatorio en este comando.

   aws codepipeline update-pipeline --cli-input-json file://pipeline.json

   Este comando devuelve la estructura completa de la canalización editada.

   nota

   El comando update-pipeline detiene la canalización. Si se está ejecutando una revisión en la canalización al ejecutar el comando update-pipeline, dicha ejecución se detiene. Debe comenzar la canalización actualizada manualmente para ejecutar dicha revisión en ella.