Nova permissão necessária para reversões

Este documento descreve uma permissão recém-exigida para reversões que será adicionada ao Cloud Deploy em 2026.

O que está sendo adicionado

A partir de 15 de setembro de 2026, será necessário ter a permissão clouddeploy.rollouts.rollback para iniciar reversões pelo Google Cloud console ou pela Google Cloud CLI. Antes dessa mudança, apenas a permissão clouddeploy.rollouts.create era necessária.

Essa permissão já existe, e os papéis do IAM, como roles/clouddeploy.releaser e roles/clouddeploy.operator, já a incluem. No entanto, ela ainda não é necessária para reversões iniciadas pelo Google Cloud console ou pela Google Cloud CLI.

O que eu preciso fazer?

Os papéis integrados do Cloud Deploy relevantes para a realização de reversões já têm essa permissão. Se você conceder apenas papéis integrados para usuários e conta de serviço que realizam reversões, não será necessário fazer nada.

Se você tiver usuários ou contas de serviço que realizam reversões usando Google Cloud o console ou a CLI gcloud e estiver concedendo papéis personalizados para essa finalidade, edite esses papéis antes de 15 de setembro de 2026 para incluir a permissão clouddeploy.rollouts.rollback.

Encontrar papéis personalizados que precisam ser atualizados

Execute o comando a seguir para encontrar papéis personalizados da sua organização que precisam da permissão clouddeploy.rollouts.rollback:

Nível do projeto

Esse comando encontra papéis personalizados definidos no seu projeto que precisam da clouddeploy.rollouts.rollback permissão:

   gcloud asset search-all-resources \
     --scope=projects/PROJECT_ID \
     --asset-types='iam.googleapis.com/Role' \
     --filter="additionalAttributes.includedPermissions:clouddeploy.rollouts.create AND NOT additionalAttributes.includedPermissions:clouddeploy.rollouts.rollback" \
     --format="table(name, additionalAttributes.includedPermissions)"

Nível da organização

Esse comando encontra papéis personalizados na sua organização, definidos no nível da organização, que precisam da clouddeploy.rollouts.rollback permissão:

   gcloud asset search-all-resources \
     --scope=organizations/ORG_NUMBER \
     --asset-types='iam.googleapis.com/Role' \
     --filter="additionalAttributes.includedPermissions:clouddeploy.rollouts.create AND NOT additionalAttributes.includedPermissions:clouddeploy.rollouts.rollback" \
     --format="table(name, additionalAttributes.includedPermissions)"

Adicionar a permissão ao papel

Para cada função personalizada que você encontrar e que precisar da nova permissão, execute o seguinte comando:

Nível do projeto

Esse comando adiciona a clouddeploy.rollouts.rollback a uma função personalizada que está definida no nível do projeto:

   gcloud iam roles update CUSTOM_ROLE_ID \
     --project=PROJECT_ID \
     --add-permissions=clouddeploy.rollouts.rollback

Nível da organização

Esse comando adiciona a clouddeploy.rollouts.rollback a uma função personalizada que é definido no nível da organização:

   gcloud iam roles update CUSTOM_ROLE_ID \
     --organization=ORG_NUMBER \
     --add-permissions=clouddeploy.rollouts.rollback

Consulte os papéis e permissões do IAM para mais informações.