Neste documento, descrevemos as contas de serviço usadas para executar o Cloud Deploy e como chamar o Cloud Deploy para executar várias operações.
O Cloud Deploy usa as seguintes contas de serviço:
Agente de serviço do Cloud Deploy
O Cloud Deploy usa essa conta de serviço para interagir com seu projeto. Não é possível substituir esse agente de serviço por uma conta de serviço alternativa, mas é possível editar permissões nele, por exemplo, quando você usa recursos fora do projeto, como uma conta de serviço ou um pool de workers particular do Cloud Build.
A conta de serviço de execução do Cloud Deploy
O Cloud Deploy usa essa conta de serviço para executar operações de renderização e implantação no Cloud Build. Essa conta precisa de permissões suficientes para ler e gravar no bucket do Cloud Storage e acessar os destinos de implantação.
A conta de serviço padrão para execução é a conta de serviço padrão do Compute Engine. É possível especificar uma conta de serviço alternativa na configuração de destino.
A conta de serviço de automação do Cloud Deploy
Essa é a conta de serviço que o Cloud Deploy usa para realizar automações. Pode ser a conta de serviço de execução padrão ou outra conta de serviço. Consulte A conta de serviço de automação para mais informações sobre essa conta de serviço.
Consulte Como criar e gerenciar contas de serviço para ver instruções sobre como editar as permissões de uma conta de serviço e criar uma conta de serviço alternativa.
Agente de serviço do Cloud Deploy
O agente de serviço do Cloud Deploy é uma conta de serviço que o Cloud Deploy usa para interagir com outros serviços do Google Cloudde que o Cloud Deploy depende. Esses serviços incluem os registros de auditoria do Cloud Build, Pub/Sub e Cloud Audit Logs.
O nome dessa conta de serviço segue este padrão:
service-<project-number>@gcp-sa-clouddeploy.
Se essa conta for removida do seu projeto, você poderá adicioná-la novamente:
Abra a página IAM no console do Google Cloud :
Selecione Incluir concessões de papel fornecidas pelo Google para exibir o agente de serviço.
Se o agente de serviço for exibido, pule o restante destas etapas.
Se o agente de serviço não aparecer, clique em Conceder acesso.
No campo Novos principais, insira o endereço do agente de serviço no seguinte formato:
service-<project-number>@gcp-sa-clouddeploy.
Clique na lista suspensa Selecionar um papel e selecione Agente de serviço do Cloud Deploy.
Clique em Salvar.
Conta de serviço de execução do Cloud Deploy
Por padrão, o Cloud Deploy é executado usando a conta de serviço padrão do Compute Engine.
O nome dessa conta de serviço segue este padrão:
[project-number]-compute@
Como essa conta de serviço é usada por muitos produtos, ela pode ter permissões
amplas. A prática recomendada é alterar o ambiente de execução para que o Cloud Deploy seja executado como uma conta de serviço diferente.
É possível alterar a conta de serviço de execução para cada
destino usando
a propriedade executionConfigs.privatePool.serviceAccount ou a
propriedade executionConfigs.defaultPool.serviceAccount na
definição de destino.
Qualquer conta de serviço definida para essas propriedades precisa ter o papel de Executor do Cloud Deploy no projeto do Cloud Deploy. Se a conta de serviço de execução padrão não tiver esse papel, execute o seguinte comando:
gcloud projects add-iam-policy-binding PROJECT_ID \
--member=serviceAccount:$(gcloud projects describe PROJECT_ID \
--format="value(projectNumber)")-compute@ \
--role="roles/clouddeploy.jobRunner"
A conta de serviço também precisará de permissões específicas do ambiente de execução para implantar no ambiente de execução escolhido. Para o Google Kubernetes Engine, é possível escolher os papéis de Desenvolvedor de contêineres e Usuário da conta de serviço. Para o Cloud Run, é possível escolher os papéis de Desenvolvedor do Cloud Run e Usuário da conta de serviço. Outros ambientes de execução usados por destinos personalizados podem exigir permissões próprias.
Quais contas de serviço criar
Se você optar por não usar a conta de serviço de execução padrão para renderização e implantação, será necessário criar uma ou mais contas de serviço alternativas para usar. Essas são as contas de serviço nas quais o Cloud Deploy é executado e estão configuradas na configuração de destino.
Um motivo para criar mais de um é ter uma conta de serviço específica ou contas para implantar em destinos restritos, como um destino de produção.
Uma abordagem possível é usar contas de serviço separadas por pipeline de entrega. Cada conta de serviço incluiria papéis com permissões suficientes para renderizar e implantar.
Para implantações no Google Kubernetes Engine, é possível restringir a conta de serviço a um namespace.
Como usar contas de serviço de um projeto diferente
Para o ambiente de execução, é possível especificar uma conta de serviço que esteja em um projeto diferente daquele em que você cria o destino:
No projeto proprietário da conta de serviço, ative a política da organização de SA entre projetos.
Conceda ao agente de serviço do Cloud Deploy (
service-<project-number>@gcp-sa-clouddeploy.) a permissãoiam.serviceAccounts.actAspara sua conta de serviço.Nesse caso,
project-numberé o projeto em que você criou o destino.Também é possível conceder o papel
roles/iam.serviceAccountUser, que inclui essa permissão, no projeto de cada conta de serviço que está em um projeto diferente daquele em que o Cloud Deploy está em execução.Conceda ao agente de serviço do Cloud Build (
service-<project-number>@gcp-sa-cloudbuild.) o papelroles/iam.serviceAccountTokenCreator.Nesse caso,
project-numberé o projeto em que você criou o destino, e esse papel é concedido no projeto da conta de serviço.É necessário conceder esse papel para cada conta de serviço configurada no ambiente de execução de um destino, se essa conta de serviço estiver em um projeto diferente daquele em que o Cloud Deploy está sendo executado.
Conceda ao autor da chamada de
gcloud deploy releases createegcloud deploy rollouts createa permissãoiam.serviceAccounts.actAsna conta de serviço ou o papelroles/iam.serviceAccountUser.
Permissões necessárias
A conta de serviço usada para configurações de renderização precisa ter permissões suficientes para acessar o bucket do Cloud Storage em que os recursos do Cloud Deploy estão armazenados (pipelines de entrega, versões, lançamentos).
O papel
roles/clouddeploy.jobRunnerinclui todas as permissões que a conta de serviço de renderização (privatePooloudefaultPool) precisa.A conta de serviço usada para implantação precisa ter permissões suficientes para implantar no cluster de destino e permissão para acessar o bucket do Cloud Storage.
A conta de serviço que chama o Cloud Deploy para criar uma versão precisa ter o papel
clouddeploy.releaser. Ele também precisa ter a permissãoiam.serviceAccount.actAspara usar a conta de serviço que renderiza manifestos (por exemplo, por meio do papelroles/iam.serviceAccountUser).A conta de serviço que chama o Cloud Deploy para promover uma versão ou criar uma
rolloutprecisa ter a permissãoiam.serviceAccount.actAspara usar a conta de serviço que implanta em destinos (por exemplo, por meio do papelroles/iam.serviceAccountUser).A conta de serviço configurada para uma automação precisa ter permissão para executar as operações que estão sendo automatizadas. Saiba mais.
A conta de serviço de automação
É possível automatizar algumas ações em uma versão. O Cloud Deploy executa essas automações usando a conta de serviço de automação, que pode ser a conta de serviço de execução padrão, uma conta de serviço não padrão usada como conta de serviço de execução ou outra conta de serviço.
Saiba mais sobre a conta de serviço de automação.
A seguir
- Saiba mais sobre IAM.
- Saiba mais sobre os papéis predefinidos do Cloud Deploy.
- Entenda como criar e gerenciar contas de serviço.