En este documento, se describen las cuentas de servicio que se usan para ejecutar Cloud Deploy y llamarlo para ejecutar diversas operaciones.
Cloud Deploy usa las siguientes cuentas de servicio:
El agente de servicio de Cloud Deploy
Cloud Deploy usa esta cuenta de servicio para interactuar con tu proyecto. No puedes reemplazar este agente de servicio por una cuenta de servicio alternativa, pero puedes editar sus permisos, por ejemplo, cuando usas recursos fuera del proyecto (como una cuenta de servicio o un grupo de trabajadores privado de Cloud Build).
La cuenta de servicio de ejecución de Cloud Deploy
Cloud Deploy usa esta cuenta de servicio para ejecutar operaciones de renderización y de implementación en Cloud Build. Esta cuenta necesita permisos suficientes para leer y escribir en el bucket de Cloud Storage y para acceder a los destinos de implementación.
La cuenta de servicio predeterminada para la ejecución es la cuenta de servicio predeterminada de Compute Engine. Puedes especificar una cuenta de servicio alternativa en la configuración de destino.
La cuenta de servicio de automatización de Cloud Deploy
Esta es la cuenta de servicio que usa Cloud Deploy para realizar automatizaciones. Esta puede ser la cuenta de servicio de ejecución predeterminada o cualquier otra cuenta de servicio. Consulta La cuenta de servicio de automatización para obtener más información sobre esta cuenta de servicio.
Consulta Crea y administra cuentas de servicio para obtener instrucciones sobre cómo editar los permisos de la cuenta de servicio y cómo crear una cuenta de servicio alternativa.
Agente de servicio de Cloud Deploy
El agente de servicio de Cloud Deploy es una cuenta de servicio que Cloud Deploy usa para interactuar con otros servicios de Google Cloud en los que se basa Cloud Deploy. Estos servicios incluyen Cloud Build, Pub/Sub y los Registros de auditoría de Cloud.
El nombre de esta cuenta de servicio sigue este patrón:
service-<project-number>@gcp-sa-clouddeploy.
Si se quita esta cuenta de tu proyecto, puedes volver a agregarla:
Abre la página de IAM en la consola de Google Cloud :
Selecciona Incluir asignaciones de roles proporcionadas por Google para mostrar el agente de servicio.
Si se muestra el agente de servicio, puedes omitir el resto de estos pasos.
Si no se muestra el agente de servicio, haz clic en Otorgar acceso.
En el campo Principales nuevas, ingresa la dirección del agente de servicio con el siguiente formato:
service-<project-number>@gcp-sa-clouddeploy.
Haz clic en la lista desplegable Selecciona un rol y elige Agente de servicio de Cloud Deploy.
Haz clic en Guardar.
Cuenta de servicio de ejecución de Cloud Deploy
Según la configuración predeterminada, Cloud Deploy se ejecuta con la cuenta de servicio predeterminada de Compute Engine.
El nombre de esta cuenta de servicio sigue este patrón:
[project-number]-compute@
Debido a que muchos productos usan esta cuenta de servicio, es posible que tenga permisos
amplios. La práctica recomendada es cambiar el entorno de ejecución para
que Cloud Deploy se ejecute como una cuenta de servicio diferente.
Puedes cambiar la cuenta de servicio de ejecución para cada
destino con
la propiedad executionConfigs.privatePool.serviceAccount o la
propiedad executionConfigs.defaultPool.serviceAccount en la
definición de destino.
Cualquier cuenta de servicio que configures para estas propiedades debe tener el rol de ejecutor de Cloud Deploy en el proyecto de Cloud Deploy. Si la cuenta de servicio de ejecución predeterminada no tiene este rol, ejecuta el siguiente comando:
gcloud projects add-iam-policy-binding PROJECT_ID \
--member=serviceAccount:$(gcloud projects describe PROJECT_ID \
--format="value(projectNumber)")-compute@ \
--role="roles/clouddeploy.jobRunner"
La cuenta de servicio también necesitará permisos específicos del entorno de ejecución para realizar la implementación en el entorno de ejecución que elijas. Para Google Kubernetes Engine, puedes elegir los roles de Desarrollador de contenedores y Usuario de cuenta de servicio. Para Cloud Run, puedes elegir los roles de desarrollador de Cloud Run y usuario de la cuenta de servicio. Otros entornos de ejecución que usan los destinos personalizados pueden requerir sus propios permisos.
Qué cuentas de servicio crear
Si decides no usar la cuenta de servicio de ejecución predeterminada para renderizar y implementar, debes crear una o más cuentas de servicio alternativas para usar. Estas son las cuentas de servicio que ejecuta Cloud Deploy y se configuran en la configuración de destino.
Un motivo para crear más de una sería tener una o más cuentas de servicio específicas para implementar en destinos restringidos, como un destino de producción.
Un enfoque posible es usar cuentas de servicio separadas por canalización de entrega. Cada una de estas cuentas de servicio incluiría roles con permisos suficientes para renderizar y realizar implementaciones.
En el caso de las implementaciones en Google Kubernetes Engine, puedes restringir la cuenta de servicio a un espacio de nombres.
Usa cuentas de servicio de un proyecto diferente
Para tu entorno de ejecución, puedes especificar una cuenta de servicio que esté en un proyecto diferente de aquel en el que creas tu destino:
En el proyecto que es propietario de la cuenta de servicio, habilita la política de la organización de SA entre proyectos.
Otorga al agente de servicio de Cloud Deploy (
service-<project-number>@gcp-sa-clouddeploy.) el permisoiam.serviceAccounts.actAspara tu cuenta de servicio.En este caso,
project-numberes el proyecto en el que creaste tu destino.También puedes otorgar el rol
roles/iam.serviceAccountUser, que incluye ese permiso, en el proyecto de cada cuenta de servicio que se encuentre en un proyecto diferente de aquel en el que se ejecuta Cloud Deploy, y en cada una de esas cuentas.Otorga al agente de servicio de Cloud Build (
service-<project-number>@gcp-sa-cloudbuild.) el rolroles/iam.serviceAccountTokenCreator.En este caso,
project-numberes el proyecto en el que creaste el destino, y este rol se otorga en el proyecto de la cuenta de servicio.Debes otorgar este rol para cada cuenta de servicio configurada en el entorno de ejecución de un destino si esa cuenta de servicio se encuentra en un proyecto diferente de aquel en el que se ejecuta Cloud Deploy.
Otorga al emisor de
gcloud deploy releases createygcloud deploy rollouts createel permisoiam.serviceAccounts.actAsen la cuenta de servicio o el rolroles/iam.serviceAccountUser.
Permisos necesarios
La cuenta de servicio que se usa para las configuraciones de procesamiento debe tener permisos suficientes para acceder al bucket de Cloud Storage en el que se almacenan los recursos de Cloud Deploy (canalizaciones de entrega, versiones y lanzamientos).
El rol
roles/clouddeploy.jobRunnerincluye todos los permisos que necesita la cuenta de servicio de procesamiento (privatePoolodefaultPool).La cuenta de servicio que se usa para la implementación debe tener permisos suficientes para implementar en el clúster de destino y permiso para acceder al bucket de Cloud Storage.
La cuenta de servicio que llama a Cloud Deploy para crear una versión debe tener el rol
clouddeploy.releaser. También debe tener el permisoiam.serviceAccount.actAspara usar la cuenta de servicio que renderiza los manifiestos (por ejemplo, a través del rolroles/iam.serviceAccountUser).La cuenta de servicio que llama a Cloud Deploy para promocionar una versión o crear un
rolloutdebe tener el permisoiam.serviceAccount.actAspara usar la cuenta de servicio que implementa en los destinos (por ejemplo, a través del rolroles/iam.serviceAccountUser).La cuenta de servicio configurada para una automatización debe tener permiso para ejecutar las operaciones que se automatizan. Obtén más información.
La cuenta de servicio de automatización
Puedes automatizar algunas acciones en una versión. Cloud Deploy ejecuta estas automatizaciones con la cuenta de servicio de automatización, que puede ser la cuenta de servicio de ejecución predeterminada, una cuenta de servicio no predeterminada que se usa como la cuenta de servicio de ejecución o alguna otra cuenta de servicio.
Obtén más información sobre la cuenta de servicio de automatización.
¿Qué sigue?
- Obtén información sobre IAM.
- Obtén información sobre los roles predefinidos de Cloud Deploy.
- Comprende cómo crear y administrar cuentas de servicio.