Consulta, edita y borra organizadores de políticas

En esta página, se describe cómo ver y borrar los orquestadores de políticas en tus carpetas o en tu organización.

Antes de comenzar

  • Revisa la Política del SO y la asignación de política del SO.
  • Revisa las cuotas de configuración del SO.
  • Asegúrate de cumplir con los requisitos previos para usar el organizador de políticas.
  • Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las APIs de Trusted Cloud by S3NS . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init
    2. Set a default region and zone.

    REST

    Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a gcloud CLI.

      Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Trusted Cloud .

Enumera los organizadores de políticas del SO

Para ver todos los orquestadores de políticas en un proyecto, una carpeta o una organización, completa los siguientes pasos:

Console

Para enumerar los orquestadores de políticas, haz lo siguiente:

  1. En la consola de Trusted Cloud , ve a la página Políticas del SO.

    Ir a Políticas del SO

  2. Haz clic en el selector de proyectos en la barra de acciones de la consola Trusted Cloud y selecciona la carpeta en la que deseas crear el orquestador de políticas.

  3. Haz clic en Global orchestrators.

gcloud

Para ver los detalles de un orquestador de políticas que se creó en una carpeta, ejecuta el comando os-config policy-orchestrators list:

  gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators list \
    --folder=FOLDER_NUMBER \

Reemplaza lo siguiente:

  • QUOTA_PROJECT_ID: Es el ID del proyecto de la cuota o el proyecto de facturación.
  • FOLDER_NUMBER: Es el ID numérico de la carpeta en la que creaste los orquestadores de políticas.

Ejemplo

  gcloud compute os-config policy-orchestrators list \
    --folder=123456 \

REST

Para ver todos los orquestadores de políticas en una carpeta, envía una solicitud GET al método folders.locations.global.policyOrchestrators.list:

GET https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators
-H "x-goog-user-project: QUOTA_PROJECT_ID"

Reemplaza FOLDER_NUMBER por el ID numérico de la carpeta en la que creaste los orquestadores de políticas.

Cómo ver los detalles de un organizador de políticas

Para ver los detalles de un orquestador de políticas en una carpeta, completa los siguientes pasos:

Console

Para ver un orquestador de políticas, haz lo siguiente:

  1. En la consola de Trusted Cloud , ve a la página Políticas del SO.

    Ir a Políticas del SO

  2. Haz clic en el selector de proyectos en la barra de acciones de la consola Trusted Cloud y, luego, selecciona el proyecto, la carpeta o la organización que contiene el orquestador de políticas.

  3. Haz clic en Global orchestrators.

  4. Selecciona el nombre del orquestador de políticas que deseas ver. Se abrirá la página Detalles del orquestador.

  5. Para ver los detalles de las políticas del SO aplicadas a las VMs, ve a la sección Políticas del SO asignadas y, luego, haz clic en Ver.

gcloud

Para ver los detalles de un orquestador de políticas que se creó en una carpeta, ejecuta el comando os-config policy-orchestrators describe:

gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators describe ORCHESTRATOR_NAME \
  --folder=FOLDER_NUMBER \

Reemplaza lo siguiente:

  • QUOTA_PROJECT_ID: Es el ID del proyecto de la cuota o el proyecto de facturación.
  • ORCHESTRATOR_NAME: Es el nombre del orquestador de políticas.
  • FOLDER_NUMBER: Es el ID numérico de la carpeta en la que creaste el orquestador de políticas.

Ejemplo

  gcloud --billing-project=my-quota-project compute os-config policy-orchestrators describe my-os-policy-orchestrator \
      --folder=123456 \

REST

Para ver los detalles de un orquestador de políticas, envía una solicitud GET al método folders.locations.global.policyOrchestrators.get.

GET https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
-H "x-goog-user-project: QUOTA_PROJECT_ID"

Reemplaza lo siguiente:

  • QUOTA_PROJECT_ID: Es el ID del proyecto de la cuota o el proyecto de facturación.
  • FOLDER_NUMBER: Es el ID numérico de la carpeta en la que existe el orquestador de políticas.
  • ORCHESTRATOR_NAME: Es el nombre del orquestador de políticas que deseas borrar.

El cuerpo de la solicitud debe estar vacío.

Edita los organizadores de políticas del SO

Puedes modificar los organizadores de políticas para agregar o actualizar las asignaciones de políticas del SO, el alcance del organizador y los recursos.

Console

Para cambiar la configuración de un organizador de políticas, haz lo siguiente:

  1. En la consola de Trusted Cloud , ve a la página Políticas del SO.

    Ir a Políticas del SO

  2. Haz clic en el selector de proyectos en la barra de acciones de la consola Trusted Cloud y selecciona el proyecto, la carpeta o la organización en la que existe el orquestador de políticas.

  3. Haz clic en Global orchestrators.

  4. Selecciona el nombre del orquestador de políticas que deseas editar. Se abrirá la página Detalles del orquestador.

  5. Haz clic en Editar.

  6. En la sección Políticas del SO, sube el archivo de políticas del SO.

  7. Opcional: En la sección Estado, selecciona una de las siguientes opciones para especificar el comportamiento del orquestador de políticas:

    • ACTIVE: Una vez creado, el organizador de políticas toma medidas de inmediato.
    • STOPPED: En este estado, no se realiza ninguna acción de inmediato cuando se crea un organizador de políticas. Puedes editar el orquestador de políticas más adelante para cambiar su estado.

  8. En la sección Alcance de la orquestación, especifica las carpetas y los proyectos en los que deseas lanzar las políticas del SO. En estos campos, solo debes ingresar los números de proyecto y de carpeta. Por ejemplo, 123456, 7654321.

  9. Opcional: Selecciona las zonas que contienen las VMs a las que deseas aplicar las políticas del SO.

  10. Opcional: En la sección Instancias de VM de destino, especifica las VMs de destino a las que deseas aplicar las políticas del SO.

    • Selecciona las familias de SO.

    • Puedes filtrar aún más las VMs si especificas incluir y excluir etiquetas.

      Por ejemplo, puedes seleccionar todas las VM de Ubuntu en el entorno de prueba y excluir aquellas que se ejecutan en Google Kubernetes Engine si especificas lo siguiente:

      • Familia del SO: ubuntu
      • Incluir: env:test, env:staging
      • Excluir: goog-gke-node

  11. Especifica un plan de lanzamiento.

    • Especifica el tamaño del conjunto (también conocido como presupuesto de interrupción). Por ejemplo, 10%.
    • Especifica el tiempo de espera. Por ejemplo, 15 minutos.

  12. Haz clic en Guardar.

gcloud

Para actualizar un orquestador de políticas, usa el comando os-config policy-orchestrators update.

   gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators update ORCHESTRATOR_NAME \
   --folder=FOLDER_NUMBER
   --state=stopped

Reemplaza lo siguiente:

  • QUOTA_PROJECT_ID: Es el ID del proyecto de la cuota o el proyecto de facturación.
  • ORCHESTRATOR_NAME: Es el nombre del orquestador de políticas.

  • FOLDER_NUMBER: Es el ID numérico de la carpeta en la que existe el orquestador de políticas.

    Ejemplo

      gcloud --billing-project=my-quota-project compute os-config policy-orchestrators update my-os-policy-orchestrator \
    --folder=123456 \
    --include-projects=5432134,4567890

REST

Para actualizar un orquestador de políticas en una carpeta, envía una solicitud PATCH al método folders.locations.global.policyOrchestrators.patch.

En el cuerpo de la solicitud, edita las especificaciones de la asignación de política del SO.

    PATCH https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
    -H "x-goog-user-project: QUOTA_PROJECT_ID"

      {
        JSON_OS_POLICY_ORCHESTRATOR
      }

Reemplaza lo siguiente:

  • QUOTA_PROJECT_ID: ID del proyecto de la cuota o del proyecto de facturación
  • FOLDER_NUMBER: Es el ID numérico de la carpeta en la que existe el orquestador de políticas.
  • ORCHESTRATOR_NAME: Es el nombre del orquestador de políticas que deseas editar.
  • JSON_OS_POLICY_ORCHESTRATOR: Es el objeto del organizador de políticas en formato JSON que define el alcance del organizador, el recurso organizado y el estado de organización. Para obtener más información sobre los parámetros y el formato, consulta Resource: folders.locations.global.policyOrchestrators.

Borra un organizador de políticas

Para borrar un orquestador de políticas y cancelar todos los lanzamientos en curso, completa los siguientes pasos:

Console

Para borrar un organizador de políticas, haz lo siguiente:

  1. En la consola de Trusted Cloud , ve a la página Políticas del SO.

    Ir a Políticas del SO

  2. Haz clic en el selector de proyectos en la barra de acciones de la consola Trusted Cloud y selecciona el proyecto, la carpeta o la organización desde los que deseas borrar el orquestador de políticas.

  3. Haz clic en Global orchestrators.

  4. Selecciona el nombre del orquestador de políticas que deseas borrar. Se abrirá la página Detalles del orquestador.

  5. Haz clic en Borrar.

gcloud

Para borrar un organizador de políticas de una carpeta, haz lo siguiente:

  1. Usa el comando os-config policy-orchestrators delete:

      gcloud --billing-project=QUOTA_PROJECT_IDcompute os-config policy-orchestrators delete ORCHESTRATOR_NAME \
    --folder=FOLDER_NUMBER \
    --policy-id=POLICY_ID

    Reemplaza lo siguiente:

    • QUOTA_PROJECT_ID: Es el ID del proyecto de la cuota o el proyecto de facturación.
    • ORCHESTRATOR_NAME: Es el nombre del orquestador de políticas.
    • FOLDER_NUMBER: Es el ID numérico de la carpeta en la que creaste el orquestador de políticas.
    • POLICY_ID: Es el ID asignado al orquestador de políticas.

    Ejemplo

      gcloud --billing-project=my-quota-project compute os-config policy-orchestrators create my-os-policy-orchestrator \
    --folder=123456 \
    --policy-id=my-policy

REST

Para borrar un organizador de políticas en una carpeta, envía una solicitud DELETE al método folders.locations.global.policyOrchestrators.delete:

DELETE https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
-H "x-goog-user-project: QUOTA_PROJECT_ID"

Reemplaza lo siguiente:

  • QUOTA_PROJECT_ID: Es el ID del proyecto de la cuota o el proyecto de facturación.
  • FOLDER_NUMBER: Es el ID numérico de la carpeta en la que existe el orquestador de políticas.
  • ORCHESTRATOR_NAME: Es el nombre del orquestador de políticas que deseas borrar.

Próximos pasos