Migra proyectos hacia una organización

Una vez que se crea un recurso de la organización de Google Cloud para tu dominio, puedes mover los proyectos existentes a la organización. Debes ser propietario y Creador del proyecto en la organización para poder mover los proyectos.

Todos los proyectos creados después de la creación del recurso de organización pertenecerán de manera automática a ese recurso. Puedes migrar un proyecto a una organización con Cloud Console, la API de Resource Manager o la herramienta de línea de comandos de gcloud.

Migra proyectos asociados a una organización

Si un proyecto está asociado a una organización, no puedes cambiarlo a Sin organización ni migrarlo a otra organización sin involucrar la asistencia de Google Cloud. Si necesitas migrar un proyecto una vez asociado a una organización, consulta Migrar proyectos a otra organización.

Migra proyectos no asociados a una organización

Para migrar un proyecto mediante la API o la herramienta de gcloud, necesitarás los siguientes permisos:

  • resourcemanager.projects.create en la organización de destino, generalmente otorgada por la función Creador de proyectos.

  • resourcemanager.projects.update y resourcemanager.projects.setIAMPolicy en el proyecto que migras, generalmente otorgado por la función Propietario.

Para migrar un proyecto con Google Cloud Console, también necesitarás el permiso resourcemanager.organizations.get en la organización de destino. Si te falta alguno de estos permisos, la organización de destino no aparecerá en Google Cloud Console.

La migración del proyecto es un proceso que no se puede revertir. Una vez que este se asocia a una organización, no puedes cambiarlo a Sin organización ni transferirlo a otra por tu cuenta. Si deseas mover un proyecto después de asociarlo a una organización, comunícate con Asistencia de Google Cloud.

Console

Sigue estos pasos para migrar un proyecto a una organización:

  1. Abre la página IAM y administración > Configuración en Cloud Console.

    Abrir la página Configuración

  2. Selecciona el Selector de proyectos en la parte superior de la página.

  3. En el Selector de organización, selecciona Sin organización. Si no estás asociado a ninguna organización, el Selector de organización no aparecerá y podrás omitir este paso.

  4. Selecciona el proyecto que deseas migrar.

    Captura de pantalla del selector de proyectos

  5. Haz clic en Migrar en la parte superior de la página.

  6. En el menú desplegable Organización, selecciona la entidad a la que quieres migrar tu proyecto.

Una vez que se agrega un proyecto a una organización, no puedes deshacer la selección por tu cuenta.

gcloud

Para migrar un proyecto a una organización, ejecuta el siguiente comando:

gcloud alpha projects move PROJECT_ID /
    --organization ORGANIZATION_ID

Donde:

  • PROJECT_ID es el ID del proyecto que quieres transferir a la organización.
  • ORGANIZATION_ID es el ID de la organización a la que quieres transferir el proyecto.

Una vez que se agrega un proyecto a una organización, no puedes deshacer la selección por tu cuenta.

API

Con la API de Resource Manager, puedes transferir un proyecto al recurso de la organización si configuras el campo parent con el ID de la organización.

Para migrar un proyecto a la organización, sigue estos pasos:

  • Obtén el objeto project con el método projects.get().
  • Configura su campo parent con el ID de organización
  • Actualiza el objeto project con el método projects.update().

No se puede modificar el campo parent luego de configurarlo.

En el siguiente fragmento de código, se muestran los siguientes pasos:

    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()

Nota sobre las implicaciones de las políticas

Las políticas de IAM que ya están definidas para un proyecto se importan con el proyecto. Esto significa que los usuarios que tienen permisos en un proyecto antes de moverlo mantienen los permisos después de que el proyecto migra a la organización.

Los permisos de IAM se heredan y son aditivos. Si hay funciones definidas a nivel de la organización, los proyectos heredan esas funciones a medida que se mueven a la organización. Si, por ejemplo, bob@myorganization.com tiene definida la función Editor del proyecto en el nivel de la organización, también tendrá esa función en cualquier proyecto que migre a la organización. Esto no afecta a los proyectos existentes, pero más usuarios pueden obtener acceso debido a la herencia de la función.

Asimismo, las políticas de la organización también se heredan en los niveles inferiores de la jerarquía. De forma predeterminada, no se define ninguna política de la organización para una organización cuando esta se crea. Si posteriormente defines políticas de la organización en tu organización, cuando muevas proyectos a ella, debes hacerlo con atención para asegurarte de que sean coherentes con esas políticas.

Migra las cuentas de facturación existentes

Si eres cliente de Google Workspace o Cloud Identity con cuentas de Cloud Billing existentes, puedes migrarlas a tu organización. Migrar una cuenta de Facturación de Cloud a una organización no afecta los servicios del proyecto.

Debes contar con estas funciones para migrar cuentas de facturación:

  • Debes ser administrador de la cuenta de facturación de la cuenta de Facturación de Cloud que deseas migrar.
  • Debes ser Creador de la cuenta de facturación en la organización a la que deseas migrar tu cuenta de Facturación de Cloud.
  • Si deseas migrar una cuenta de Facturación de Cloud de una organización existente, debes ser un administrador de la cuenta de facturación de la organización desde la que migras la cuenta de Facturación de Cloud.

Para obtener información sobre cómo otorgar estas funciones, consulta Descripción general del control de acceso a la Facturación de Cloud.

Para migrar tus cuentas de facturación existentes a una organización, sigue estos pasos:

  1. Ve a la página de Facturación de Cloud Console:
    Ir a la página de Facturación
  2. En el menú **Seleccionar una organización**, selecciona una organización para ver las cuentas de Facturación de Cloud asociadas a ella o selecciona Sin organización para ver las cuentas de facturación que no están asociadas con una organización.
  3. En Nombre de la cuenta de facturación, haz clic en el nombre de la cuenta de Facturación de Cloud que deseas migrar. Se abrirá la página de descripción general de la cuenta de facturación.
  4. En el menú de navegación de Facturación, haz clic en Administración de cuentas.
  5. En la parte superior de la página Administración de cuentas, haz clic en Cambiar organización y, luego, selecciona la organización a la que deseas migrar la cuenta de Facturación de Cloud.