Una implementación de Cloud Deploy incluye fases. Una fase es una agrupación ordenada y lógica de tareas que se deben realizar en un lanzamiento.
Cada fase incluye trabajos, que son las acciones que se deben realizar en cada fase (por ejemplo, deploy o verify). Además, cada trabajo puede tener cero o más ejecuciones.
La ejecución de un trabajo es una instancia de un trabajo. Si el trabajo no se ejecutó, no hay ejecuciones de trabajos.
En este documento, se describen las fases, trabajos y ejecución de trabajos y cómo administrarlas.
Estructura de un lanzamiento
Un lanzamiento es un recurso de Cloud Deploy que asocia una versión con un destino.
Fases
Un lanzamiento consiste en una o más fases.
Para una estrategia de implementación estándar, solo hay una fase: stable.
Para una estrategia de implementación canary, hay una fase independiente para cada porcentaje configurado. Por ejemplo, si configuras un canario que implementa el 25%, luego el 50% y, luego, el 100%, habrá tres fases:
canary-25canary-50stable
Estos nombres de fase son estándar: canary-[PERCENTAGE] para etapas canary y
stable para la fase del 100%. Sin embargo, si configuras una canaria manual o personalizada, puedes controlar los nombres de las fases.
Trabajos y ejecuciones de trabajos
Cada fase de lanzamiento incluye uno o más trabajos.
Para un lanzamiento en una implementación estándar
de implementación sin la verificación de implementación habilitada, hay una fase
(stable).
En el caso del lanzamiento de versiones canary, habrá una fase para cada parte
(por ejemplo, canary-25, canary-50, stable) y, para cada fase, hay un
Trabajo deploy. Si la verificación está habilitada, también hay un trabajo verify para cada una
en la fase de desarrollo.
Una ejecución de trabajo es una instancia de un trabajo. Por ejemplo, si se ejecuta un trabajo para un trabajo deploy, se considera lo siguiente:
y, si tiene éxito, no hay más ejecuciones de trabajos para ese trabajo. Si falla, se puede volver a intentar cuando se ejecute otro trabajo.
Cómo omitir fases la primera vez
Algunas estrategias de implementación (por ejemplo, versiones canary) distribuyen el tráfico entre versiones nuevas y anteriores. Si es la primera vez que implementas en un destino porque no hay una versión antigua, por lo que no podemos distribuir el tráfico.
Por este motivo, cuando implementas una versión canary por primera vez, omitimos la versión canary
o fases y ejecuta la fase stable. Después de eso, se implementa la aplicación, y las implementaciones canary futuras incluirán las fases canary.
En una situación real, por lo general, ejecutará una implementación de versiones canary en la que Tu aplicación ya se está ejecutando, por lo que la omisión de esta fase será poco frecuente.
Estados dentro de un lanzamiento
Las implementaciones, las fases, los trabajos y las ejecuciones de trabajos tienen estados. En esta sección, se describen los estados de cada uno.
Estados de lanzamiento
Un lanzamiento tendrá uno de los siguientes estados:
APPROVAL_REJECTEDEl lanzamiento requería la aprobación pero se rechazó la aprobación.
CANCELLEDEs el estado final de los lanzamientos que un usuario canceló.
CANCELLINGUn usuario canceló el lanzamiento, pero la cancelación no finalizó el procesamiento de datos.
HALTEDEn una implementación paralela, si hay uno o más elementos secundarios lanzamiento falla, pero al menos un lanzamiento secundario se realiza lanzamiento de control se DETENER si hay más fases después de la actual.
Para reanudar un lanzamiento detenido de un controlador, haz lo siguiente:
Cancela el lanzamiento del controlador
Vuelve a intentar o ignora los trabajos con errores en los lanzamientos secundarios
IN_PROGRESSSe está procesando una ejecución de trabajo.
FAILEDUn trabajo falló y el usuario no eligió ignorar la falla.
PENDINGAún no se ha iniciado el procesamiento del lanzamiento. Este estado pasa a
IN_PROGRESSoCANCELED.PENDING_APPROVALEl lanzamiento requiere aprobación pero aún no se aprobó.
PENDING_RELEASEEl lanzamiento está esperando a que se renderice la versión.
SUCCEEDEDEl lanzamiento finalizó, pero no falló.
Estados de fase
Una fase tendrá uno de los siguientes estados:
PENDINGLa fase está esperando a que finalice otra fase del lanzamiento.
IN_PROGRESSComenzó la fase.
SUCCEEDEDLa fase se completó correctamente.
FAILEDSe produjo un error en un trabajo de la fase, y el usuario no optó por ignorar la falla.
ABORTEDSe produjo un error en una fase anterior.
SKIPPEDCuando ejecutas una estrategia de implementación, como canary, Cloud Deploy se pasa a la fase
stableen los casos en los que aún no hay una versión en ejecución de la aplicación con la que dividir el tráfico. En este caso, el estado se establece enSKIPPED.
Estados del trabajo
Un trabajo tendrá uno de los siguientes estados:
ABORTEDSi una fase falla, las fases posteriores se anulan.
Si un trabajo falla y esa falla no se ignora, se abortan los trabajos posteriores. Por ejemplo, si una fase incluye un trabajo de implementación y uno de verificación, y el trabajo de implementación falla, se aborta el trabajo de verificación.
DISABLEDEs posible que algunos trabajos de una fase estén inhabilitados. Por ejemplo, las fases siempre incluyen trabajos de verificación, independientemente de si la verificación está habilitada o no. Si la verificación no está habilitada, el trabajo de verificación se establece en
DISABLED.FAILEDUna ejecución de trabajo para esta tarea falló, y el usuario no eligió ignorar la falla.
El usuario eligió finalizar la ejecución del trabajo para este trabajo.
IGNOREDUna ejecución de trabajo falló, y el usuario eligió ignorar la falla.
IN_PROGRESSSe está ejecutando un trabajo para este trabajo.
PENDINGLa ejecución de la tarea está esperando comenzar porque no finalizó otra fase o tarea.
SKIPPEDCuando ejecutas una estrategia de implementación, como canary, Cloud Deploy se pasa a la fase
stableen los casos en los que aún no hay una versión en ejecución de la aplicación con la que dividir el tráfico. En este caso, el estado es Se configura comoSKIPPEDen trabajos dentro de la fase o fases omitidas.SUCCEEDEDLa ejecución del trabajo finalizó correctamente y comenzó el siguiente trabajo de la fase, o que la siguiente fase haya comenzado o esté lista para comenzar (posiblemente, las actualizaciones de usuario entrada), o el lanzamiento finalizó.
Estados de ejecución del trabajo
FAILEDLa ejecución del trabajo falló durante la ejecución.
IN_PROGRESSSe inició la ejecución del trabajo, pero no finalizó.
TERMINATEDEl usuario finalizó la ejecución del trabajo.
TERMINATINGEl usuario finalizó la ejecución del trabajo, pero no finalizó. finalizando aún.
SUCCEEDEDCuando una ejecución de trabajo finaliza correctamente, sin errores ni que un usuario la finalice, se coloca en un estado
SUCCEEDED, que
Administra el lanzamiento
Con la consola de Google Cloud o el SDK de Google Cloud, puedes hacer lo siguiente con un lanzamiento de Cloud Deploy:
Si usas la implementación en paralelo con una estrategia de implementación canary, consulta este documento.
Adelantar un lanzamiento
En el caso de los objetivos configurados para utilizar una estrategia de implementación distinta de la “estándar”, tú necesitas hacer que el lanzamiento avance de fase a fase.
Por ejemplo, si tienes un objetivo configurado para realizar una implementación canary simple
con solo las fases del 50% y stable (100%), deberás avanzar el lanzamiento
una vez, de la fase canary-50 a la fase stable (100%).
gcloud
gcloud deploy rollouts advance ROLLOUT_NAME \
--release=RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--region=REGION
Aquí:
ROLLOUT_NAME es el nombre del lanzamiento actual
el cual pasarás a la siguiente fase.
RELEASE_NAME es el nombre de la versión de la que forma parte este lanzamiento.
PIPELINE_NAME es el nombre de la canalización de entrega que usas para administrar la implementación de esta versión.
REGION es el nombre de la región en la que
versión, por ejemplo, us-central1. Este campo es obligatorio.
Consulta la referencia del SDK de Google Cloud para obtener más información sobre el
comando gcloud deploy rollouts advance.
Console
Haz clic en tu canalización que se muestra en la lista de canalizaciones de publicación.
En la página Detalles de la canalización de entrega, se muestra una representación gráfica de el progreso de tu canalización de entrega.
En la pestaña Lanzamientos, en Detalles de canalización de entrega, haz clic en el nombre del lanzamiento.
Se mostrará la página de detalles del lanzamiento.
Observa que, en este ejemplo, el lanzamiento tiene una fase
canary-50y una Fasestable: Tu lanzamiento puede tener más fases o diferentes fases.Haz clic en Adelantar lanzamiento.
El lanzamiento pasa a la siguiente fase.
Cancela un lanzamiento
Puedes cancelar cualquier lanzamiento que no haya finalizado. También puedes cancelar una implementación que falló para evitar que se realicen más acciones (como ignorarla o volver a intentarla). El lanzamiento Debe tener uno de los siguientes estados:
FAILEDHALTEDIN_PROGRESSPENDINGPENDING_APPROVALPENDING_RELEASE
Después de cancelar un lanzamiento, este estará en un estado CANCELLING hasta que se completen todas las ejecuciones de trabajos pendientes. Puedes finalizar las ejecuciones de trabajos pendientes que no quieras esperar. Una vez que el lanzamiento sea CANCELLED, ya no se podrá avanzar ni modificar.
Para cancelar un lanzamiento, sigue estos pasos:
gcloud
gcloud deploy rollouts cancel ROLLOUT_NAME \
--release=RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--region=REGION
Aquí:
ROLLOUT_NAME es el nombre del lanzamiento actual
el cual pasarás a la siguiente fase.
RELEASE_NAME es el nombre de la versión de la que forma parte este lanzamiento.
PIPELINE_NAME es el nombre de la canalización de entrega que usas para administrar la implementación de esta versión.
REGION es el nombre de la región en la que se creó la versión, por ejemplo, us-central1. Este campo es obligatorio.
Consulta la referencia del SDK de Google Cloud para obtener más información sobre el
comando gcloud deploy rollouts cancel.
Console
Haz clic en tu canalización que aparece en la lista de canalizaciones de publicación.
En la página Detalles de la canalización de entrega, se muestra una representación gráfica de el progreso de tu canalización de entrega.
En la pestaña Lanzamientos, en Detalles de canalización de entrega, haz clic en el nombre del lanzamiento.
Se mostrará la página de detalles del lanzamiento.
Observa que, en este ejemplo, el lanzamiento tiene una fase
canary-50y una fasestable. Tu lanzamiento puede tener más fases o diferentes fases.Haz clic en Cancelar lanzamiento.
Se canceló el lanzamiento.
Finaliza la ejecución de un trabajo
Puedes finalizar una ejecución de trabajo que esté en curso. Es posible que quieras hacer esto,
por ejemplo, si la ejecución de un trabajo parece tardar demasiado o no funciona como
lo esperado. La ejecución del trabajo debe ser IN_PROGRESS para que puedas finalizarlo.
gcloud
gcloud deploy job-runs terminate JOB_RUN_ID \
--release=RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--rollout=ROLLOUT_NAME \
--region=REGION
Aquí:
JOB_RUN_ID es el (UUID) de la ejecución de trabajo que deseas cerrar. Puedes encontrar el ID de ejecución del trabajo en la consola de Google Cloud, para
Cloud Deploy, en la página de lanzamiento:
También puedes obtener el ID de las ejecuciones del trabajo con el comando gcloud deploy rollouts
describe.
RELEASE_NAME es el nombre de la versión de la que forma parte esta ejecución de trabajo.
PIPELINE_NAME es el nombre de la canalización de entrega que usas para administrar la implementación de esta versión.
ROLLOUT_NAME es el nombre del lanzamiento del que forma parte la ejecución de esta tarea.
REGION es el nombre de la región en la que se creó la versión, por ejemplo, us-central1. Este campo es obligatorio.
Consulta la referencia del SDK de Google Cloud para obtener más información sobre el
comando gcloud deploy job-runs terminate.
Console
Haz clic en la canalización que se muestra en la lista de canalizaciones de entrega.
La página Detalles de la canalización de entrega muestra una representación gráfica del progreso de tu canalización de entrega.
En la pestaña Lanzamientos, en Detalles de la canalización de entrega, haz clic en el nombre del lanzamiento.
Se mostrará la página de detalles del lanzamiento.
Observa que, en este ejemplo, el lanzamiento tiene una fase
canary-50y una fasestable. Es posible que el lanzamiento tenga más fases o fases diferentes.En Fases, haz clic en la fase que incluye el trabajo cuyo trabajo se ejecutó. estás dando por terminada.
En Ejecuciones de trabajos, selecciona la ejecución del trabajo específica que estás finalizando y, luego, Haz clic en Finalizar.
La ejecución del trabajo finaliza, y el estado del trabajo, como se muestra en las Fases es
Failure.
Después de que finalizas la ejecución de un trabajo, este se considera con errores y puedes hacer cualquier de las siguientes opciones:
- Déjalo así y omite el lanzamiento con errores.
- Reintentar el trabajo
- Ignora el trabajo y continúa con el siguiente trabajo o fase del lanzamiento.
Ignora un trabajo
Puedes ignorar un trabajo con errores y pasar de inmediato al siguiente trabajo de la fase. Es posible que esa tarea fallara por cualquier motivo, por ejemplo, porque tú o alguien más finalizaron una ejecución de la tarea.
Un trabajo con errores significa una fase y un lanzamiento con errores. Sin embargo, si ignoras
la falla, tanto la fase como el lanzamiento pueden avanzar y, en última instancia,
tienen SUCCEEDED estados.
gcloud
gcloud deploy rollouts ignore-job ROLLOUT_NAME \
--release=RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--job-id=JOB_ID \
--phase-id=PHASE_ID \
--region=REGION
Aquí:
ROLLOUT_NAME es el nombre del lanzamiento de este trabajo
es parte de la ejecución.
RELEASE_NAME es el nombre de la versión actual que incluye esta tarea.
PIPELINE_NAME es el nombre de la canalización de entrega que usas para administrar la implementación de esta versión.
JOB_ID es el nombre del trabajo que se debe ignorar, por
DEPLOY de ejemplo. Puedes encontrar el nombre del trabajo en la tabla Fases del lanzamiento en la consola de Google Cloud:
PHASE_ID es el nombre de la fase que incluye el trabajo que estás ignorando.
REGION es el nombre de la región en la que se creó la versión, por ejemplo, us-central1.
Consulta la referencia del SDK de Google Cloud para obtener más información sobre el
comando gcloud deploy rollouts ignore-job.
Console
Haz clic en tu canalización que se muestra en la lista de canalizaciones de publicación.
La página Detalles de la canalización de entrega muestra una representación gráfica del progreso de tu canalización de entrega.
En la pestaña Lanzamientos, en Detalles de la canalización de entrega, haz clic en el nombre del lanzamiento.
Se muestra la página de detalles del lanzamiento para ese lanzamiento.
Selecciona el trabajo con errores que deseas ignorar.
Haz clic en el botón Ignorar fallas.
Se ignora la ejecución del trabajo con errores y el lanzamiento continúa como si el trabajo habían tenido éxito. Es decir, si hay otros trabajos en la misma fase, estos se ejecutan. De lo contrario, el lanzamiento está listo para avanzar a la siguiente y la fase de desarrollo.
Reintentar un trabajo con errores
Puedes reintentar la ejecución de un trabajo que falló. La tarea puede fallar por cualquiera de los siguientes motivos:
No se pudo completar la ejecución de un trabajo.
Por ejemplo, es posible que se haya producido un error en los permisos.
Un usuario finalizó una ejecución de trabajo desde ese trabajo.
Si finalizas una ejecución de trabajo, se producirá un trabajo con errores, que puedes reintentar.
Falló una prueba de verificación.
En un trabajo de verificación, una prueba de verificación falló. A pesar de que el trabajo de verificación se completó correctamente, una de tus las pruebas de verificación fallaron y las propagamos de nuevo al trabajo de verificación. En este caso, reintentarías la tarea como parte de la depuración de la prueba fallida en tu aplicación.
Para reintentar un trabajo con errores, haz lo siguiente:
gcloud
gcloud deploy rollouts retry-job JOB_NAME \
--release=RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--rollout=ROLLOUT_NAME \
--phase=PHASE_ID \
--region=REGION
Aquí:
JOB_NAME es el nombre de la tarea que intentas nuevamente. Por ejemplo, si vuelves a intentar la tarea de verificación después de una verificación con errores, este valor sería verify.
RELEASE_NAME es el nombre de la versión que esta
de la que forma parte la ejecución del trabajo.
PIPELINE_NAME es el nombre de la canalización de entrega que usas para administrar la implementación de esta versión.
ROLLOUT_NAME es el nombre del lanzamiento del que forma parte la ejecución de esta tarea.
PHASE_ID es el nombre de la fase de la que forma parte este trabajo. Por ejemplo, canary-50 o stable.
REGION es el nombre de la región en la que se creó la versión, por ejemplo, us-central1. Este campo es obligatorio.
Consulta la referencia del SDK de Google Cloud para obtener más información sobre el
comando gcloud deploy rollouts retry-job.
Console
Haz clic en tu canalización que se muestra en la lista de canalizaciones de publicación.
La página Detalles de la canalización de entrega muestra una representación gráfica del progreso de tu canalización de entrega.
En la pestaña Lanzamientos, en Detalles de canalización de entrega, haz clic en el nombre del lanzamiento.
Se mostrará la página de detalles del lanzamiento.
En Fases y trabajos, haz clic en la fase que incluye el trabajo que quieres volver a intentar.
Selecciona el trabajo que quieres volver a intentar.
Haz clic en Reintentar y confirma tu decisión.
La ejecución del trabajo se vuelve a ejecutar y el estado del trabajo, como se muestra en la tabla Fases, es "en curso". Si hay otros trabajos en el mismo de servicio, se ejecutan. De lo contrario, el lanzamiento está listo para avanzar a la siguiente fase.
¿Qué sigue?
Obtén más información sobre cómo funcionan las estrategias de implementación en Cloud Deploy.
Consulta la documentación de la arquitectura del servicio de Cloud Deploy para obtener más información sobre cómo las implementaciones, las fases, los trabajos y las ejecuciones de trabajos se ajustan al resto de Cloud Deploy.