Migrar projetos para uma organização

Depois que um recurso Organização do Google Cloud tiver sido criado para seu domínio, você poderá mover seus 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 Cloud, a API Resource Manager 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 organização sem envolver o suporte ao cliente do Google Cloud. 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, você precisará ter o papel de Criador de Projetos (roles/resourcemanager.projectCreator) na organização que receberá o projeto. Você também precisará do papel de Movimentador de projetos (roles/resourcemanager.projectMover) no projeto que está migrando. Se você não tiver esses papéis, a organização de destino não aparecerá no Console do Google Cloud como opção de migração.

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 de ele estar associado a uma organização, entre em contato com o Suporte ao cliente do Google Cloud.

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 Cloud.

    Abrir a página Configurações

  2. Selecione o Seletor de projetos na parte superior da página.

  3. No seletor de organização, selecione Nenhuma organização. Se você não estiver associado a nenhuma organização, o seletor de organização não será exibido, e você poderá ignorar esta etapa.

  4. Selecione o projeto que você quer migrar.

    Captura de tela do seletor de projetos

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

  6. 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 ID do projeto que você quer mover para a organização;
  • ORGANIZATION_ID é o ID 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 Resource Manager API, você pode mover um projeto para o recurso da organização definindo seu campo parent como o ID da organização.

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

  • Receba o objeto project usando o método projects.get().
  • Defina o campo parent como o ID 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. Para migrar contas de faturamento, você deve ser um Criador da conta de faturamento e um Administrador de faturamento na organização para a qual quer migrar seu projeto. 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 Cloud:
    ACESSAR A PÁGINA DE 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. A página de visão geral da conta de faturamento será exibida.
  4. Ao lado de Faturamento da conta à direita, clique em Gerenciar.
  5. Na página de gerenciamento de conta exibida, clique em Alterar Organização e selecione a organização para a qual 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