Como migrar projetos para uma organização

Após a criação do recurso Organização no domínio, é possível migrar os projetos existentes para a organização. Para migrar os projetos, é necessário que o usuário seja o proprietário ou editor do projeto, e que tenha o papel de Criador de projetos na organização.

Todos os projetos gerados após a criação do recurso Organização pertencerão automaticamente a ele. É possível migrar um projeto para uma organização usando o Console do GCP, a Resource Manager API ou a ferramenta de linha de comando gcloud.

Como migrar projetos em uma organização

Se um projeto estiver associado a uma organização, não será possível alterá-lo para Nenhuma organização ou migrá-lo para outra sem contar com o suporte do Google Cloud Platform. Se você precisar migrar um projeto depois de associá-lo a uma organização, consulte Como migrar projetos para outra organização.

Como migrar projetos sem organização

Para migrar um projeto, será preciso ter o papel Criador de projetos (roles/resourcemanager.projectCreator) na organização que você quer usar para migrar seu projeto. O papel Transportador de projetos (roles/resourcemanager.projectMover) também será necessário para o projeto ao qual você está migrando. Se você não tiver esses papéis, a organização de destino não aparecerá como uma opção para a migração no Console do Google Cloud Platform.

A migração do projeto é irreversível. Depois de associado a uma organização, não é possível alterar o projeto de volta para Sem organização ou migrá-lo para outra por conta própria. Se você quiser mover um projeto depois que ele estiver associado a uma organização, entre em contato com o suporte do GCP.

Console

Se você quiser migrar um projeto para uma organização, faça o seguinte:

  1. Abra a página IAM e administrador > Configurações no Console do GCP.

    Abrir a página Configurações

  2. Na lista suspensa Selecionar organização, na parte superior da página, selecione Nenhuma organização e, em seguida, escolha o projeto que você quer migrar.

    Captura de tela do seletor de projetos

  3. Na parte superior da página, clique em Migrar.

  4. Na lista suspensa Organização, selecione a organização que você quer usar para migrar seu projeto.

Depois que um projeto for adicionado a uma organização, não será possível desfazer a seleção por conta própria.

gcloud

Se você quiser migrar um projeto para uma organização, execute o seguinte comando:

gcloud alpha projects move PROJECT_ID /
    --organization ORGANIZATION_ID

Em que:

  • PROJECT_ID é o código do projeto que você quer mover para a organização
  • ORGANIZATION_ID é o código da organização para onde você quer migrar o projeto.

Depois que um projeto for adicionado a uma organização, não será possível desfazer a seleção por conta própria.

API

Usando a API Resource Manager, é possível mover um projeto para o recurso da organização. Para isso, basta definir o campo parent dele como o código da organização.

Se você quiser migrar um projeto para a organização, faça o seguinte:

  • Encontre o objeto project usando o método projects.get().
  • Defina o campo parent dele como o código da organização.
  • Atualize o objeto project usando o método projects.update().

Não é possível alterar o campo parent depois de defini-lo.

O snippet de código a seguir demonstra as etapas acima:

    project = crm.projects().get(projectId=flags.projectId).execute()
    project['parent'] = {
        'type': 'organization',
        'id': flags.organizationId
    }

    project = crm.projects().update(
    projectId=flags.projectId, body=project).execute()

Observação sobre as implicações relacionadas às políticas

As políticas do Cloud IAM que já foram definidas em um determinado projeto são importadas junto com o projeto. Isso significa que os usuários que têm permissões em um projeto antes da migração continuam a ter as mesmas permissões após a migração do projeto para a organização.

As permissões do Cloud IAM são herdadas e cumulativas. Portanto, se houver papéis definidos no nível da organização, esses papéis serão herdados pelos projetos quando eles forem migrados para a organização. Por exemplo, se jose@minhaorganizacao.com tiver o papel de Editor de projetos definido no nível da organização, ele também terá esse papel em qualquer projeto que seja migrado para a organização. Isso não corrompe os elementos dos projetos existentes. Porém, mais usuários poderão herdar acessos.

Da mesma forma, as políticas da organização também são herdadas na hierarquia. Por padrão, nenhuma política é definida quando a organização é criada. Se você definiu políticas de organização posteriormente, tenha cuidado ao migrar projetos para a organização e verifique se eles são consistentes com as políticas.

Migrar contas de faturamento atuais

Se você for um cliente do G Suite ou do Cloud Identity com contas de faturamento atuais, poderá migrá-las para sua organização. Você precisa ser um Criador da conta de faturamento e um Administrador de faturamento para migrar as contas de faturamento. Para saber mais sobre como conceder esses papéis, consulte Como gerenciar papéis da organização padrão. Migrar uma conta de faturamento para uma organização não afeta os serviços do projeto.

Para migrar suas contas de faturamento existentes para uma organização, siga as etapas abaixo:

  1. Acesse a página Faturamento no console do GCP:
    ACESSAR A PÁGINA "FATURAMENTO"
  2. No menu suspenso no topo da página, selecione Sem organização para ver as contas de faturamento que não estão associadas a uma organização.
  3. Em Nome da conta de faturamento, clique no nome da conta de faturamento que você quer migrar.
  4. Nos detalhes da conta de faturamento exibidos, clique em Alterar organização e selecione a organização a que você quer migrar a conta de faturamento.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Resource Manager