Migrar proyectos a 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 o editor del proyecto 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.

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

Migrar 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 de Creador de proyectos.

  • resourcemanager.projects.update en el proyecto que migras, generalmente otorgado por las funciones de Propietario, Editor o Migrador de proyectos.

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

Para migrar un proyecto mediante 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

Leyenda:

  • PROJECT_ID es el ID del proyecto que deseas transferir a la organización.
  • ORGANIZATION_ID es el ID de la organización a la que deseas 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 Cloud IAM que ya se definieron 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 Cloud IAM se heredan y son acumulativos; si hay funciones definidas en el nivel de la organización, los proyectos heredan esas funciones cuando 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 G Suite o Cloud Identity y tienes cuentas de facturación existentes, puedes migrarlas a tu organización. Debes ser Creador de la cuenta de facturación y Administrador de facturación de la organización a la que deseas migrar tu proyecto si quieres migrar cuentas de facturación. Si deseas obtener más información sobre estas funciones, consulta la página sobre la administración de las funciones predeterminadas de la organización. Migrar una cuenta de facturación a una organización no influye en los servicios del proyecto.

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ú desplegable de la parte superior de la página, selecciona Sin organización para ver las cuentas de facturación que no están asociadas a una organización.
  3. En Nombre de la cuenta de facturación, haz clic en el nombre de la cuenta de facturación que deseas migrar. Aparecerá la página de resumen de la cuenta de facturación.
  4. Junto a Cuenta de facturación, a la derecha, haz clic en Administrar.
  5. En la página de administración de cuentas que aparecerá, haz clic en Cambiar organización y, luego, selecciona la organización a la que deseas migrar la cuenta de facturación.