Configura el Agente de operaciones para la solución Bare Metal

El Agente de operaciones recopila registros y métricas en el servidor de la solución Bare Metal. Envía tus registros a Cloud Logging y tus métricas a Cloud Monitoring. Para obtener más información sobre el Agente de operaciones, consulta la Descripción general del Agente de operaciones.

Antes de comenzar

• Asegúrate de que el servidor de la solución Bare Metal ejecute un SO compatible. Los siguientes SO son compatibles con el Agente de operaciones:

  • RHEL 7.x
  • RHEL 8.x
  • SLES 12.x
  • SLES 15.x

• Asegúrate de tener las credenciales de la cuenta de servicio en el servidor de la solución Bare Metal que autoricen la comunicación con Cloud Logging y Cloud Monitoring. Si no tienes las credenciales requeridas, debes autorizar al Agente de operaciones antes de instalarlo.

• Habilita los servicios para la API de Cloud Logging y la API de Cloud Monitoring.

Autorizar el agente de operaciones

Antes de instalar el agente de operaciones, debes asegurarte de que tenga permiso para enviar información a Google Cloud. Este permiso se otorga mediante el uso de credenciales de cuenta de servicio que deben almacenarse en el servidor de la solución Bare Metal. Estas credenciales sirven como credenciales predeterminadas de la aplicación (ADC) para el Agente de operaciones.

La autorización hace referencia al proceso de determinar qué permisos tiene un cliente autenticado sobre un conjunto de recursos. Google Cloud autoriza al Agente de operaciones en un servidor de la solución Bare Metal mediante ADC.

El Agente de operaciones es compatible con las ADC que se autentican con una clave privada de una cuenta de servicio. La clave autoriza el par de claves en una cuenta de servicio de un proyecto, lo que te permite crear un token de acceso. Luego, el token se usa para proporcionar una identidad, de modo que puedas interactuar con las APIs de Google Cloud en nombre de la cuenta de servicio.

La autorización del agente implica los siguientes pasos:

1. Crea una cuenta de servicio.
2. Autoriza la cuenta de servicio con una clave privada.
3. Autoriza al Agente de operaciones.

Si ya tienes las credenciales requeridas, puedes omitir este proceso y, luego, instalar el Agente de operaciones.

Crea una cuenta de servicio y una clave

En esta sección, se describe cómo crear una cuenta de servicio nueva y otorgarle las funciones necesarias, y cómo actualizar una cuenta de servicio existente si no tiene las funciones necesarias.

Para crear una cuenta de servicio, completa los procedimientos de creación de una cuenta de servicio con la siguiente información:

1. Selecciona el mismo proyecto de Google Cloud que contiene el servidor de la solución Bare Metal para crear la cuenta de servicio.
2. En el menú desplegable Rol, selecciona los siguientes roles:
   • Monitoring > Escritor de métricas de Monitoring.
   • Logging > Escritor de registros.
3. Selecciona JSON como el Tipo de clave.

4. Haz clic en Crear.

   Cuando haces clic en Crear, se descarga un archivo que contiene una clave de cuenta de servicio a tu sistema local. Para obtener más información, consulta Crea y borra claves de cuentas de servicio.

Nota: Las claves de cuenta de servicio representan un riesgo de seguridad si no se administran de forma correcta. Eres responsable de la seguridad de la clave privada y de otras operaciones que se describen en Prácticas recomendadas para administrar claves de cuentas de servicio. Si no se te permite crear una clave de cuenta de servicio, es posible que la creación de claves de cuentas de servicio esté inhabilitada para tu organización. Para obtener más información, consulta Administra los recursos de la organización con seguridad de forma predeterminada.

A continuación, autoriza al Agente de operaciones usando una clave privada de cuenta de servicio.

Autoriza una cuenta de servicio con una clave privada

Para autorizar al Agente de operaciones con una clave privada de la cuenta de servicio, haz lo siguiente:

1. Copia el archivo de claves privadas en la siguiente ubicación del servidor de la solución Bare Metal para que el Agente de operaciones pueda reconocer las credenciales.

   Advertencia: Si ya tienes un archivo de credenciales, asegúrate de que las credenciales nuevas no reemplacen las de tus aplicaciones actuales.

   /etc/google/auth/application_default_credentials.json
   

2. Crea una variable de entorno para que apunte al archivo de credenciales en tu estación de trabajo. En el siguiente ejemplo, se crea una variable llamada CREDS:

   CREDS="~/Downloads/PROJECT-NAME-KEY-ID.json"
   

3. Transfiere la clave de la cuenta de servicio al servidor de la solución Bare Metal.

   Nota: En las siguientes instrucciones, se da por hecho que tienes un entorno de Linux en tu sistema local y en tu servidor. Si usas un entorno diferente, consulta la documentación de tu proveedor de servicios en la nube para saber cómo copiar el archivo de claves privadas. Asegúrate de que el archivo de claves privadas esté en la misma ubicación que la variable CREDS.

   En tu sistema local, usa la herramienta de línea de comandos de scp.

   1. Ve a la página Servidores.

      Ir a Servidores

   2. Identifica la siguiente información para tu servidor:

      • ID del proyecto
      • Nombre del servidor
      • Ubicación del servidor

   3. En el servidor de la solución Bare Metal, ejecuta los siguientes comandos:

      GOOGLE_APPLICATION_CREDENTIALS="/etc/google/auth/application_default_credentials.json"
      sudo mkdir -p /etc/google/auth
      sudo mv "$HOME/temp.json" "$GOOGLE_APPLICATION_CREDENTIALS"
      sudo chown root:root "$GOOGLE_APPLICATION_CREDENTIALS"
      sudo chmod 0400 "$GOOGLE_APPLICATION_CREDENTIALS"
      
      

      La variable GOOGLE_APPLICATION_CREDENTIALS debe ser visible para el proceso del Agente de operaciones. Si el archivo de credenciales no se encuentra en la ubicación predeterminada que se mencionó antes, además de los comandos de los ejemplos anteriores, asegúrate de que GOOGLE_APPLICATION_CREDENTIALS esté definido y sea visible para el proceso del Agente de operaciones.

Autorizar el agente de operaciones

1. Edita el archivo /etc/systemd/system.conf para agregar la siguiente información. Crea el archivo si no existe.

   DefaultEnvironment=GOOGLE_APPLICATION_CREDENTIALS=path_to_credentials_file BMS_PROJECT_ID=PROJECT_ID BMS_LOCATION=REGION BMS_INSTANCE_ID=SERVER_ID
   

2. Vuelve a cargar las variables de entorno.

   sudo systemctl daemon-reload
   

   El servidor de la solución Bare Metal ahora tiene las credenciales que necesita el Agente de operaciones.

3. En el servidor de la solución Bare Metal, reinicia el Agente de operaciones para usar las credenciales nuevas mediante la ejecución del siguiente comando:

   sudo service google-cloud-ops-agent restart
   

Instalar el Agente de operaciones.

Para instalar el agente con la línea de comandos, haz lo siguiente:

1. Abre una conexión de terminal en el servidor de la solución Bare Metal con SSH o una herramienta similar y asegúrate de tener acceso sudo.

2. Cambia a un directorio para el que tengas acceso de escritura. Por ejemplo, tu directorio principal.

3. Descarga y ejecuta la secuencia de comandos de instalación del Agente de operaciones. Para ello, ejecuta los siguientes comandos:

   curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
   

   sudo REPO_SUFFIX=bms bash add-google-cloud-ops-agent-repo.sh --also-install
   

Una vez finalizada la instalación, el Agente de operaciones se inicia automáticamente.

¿Qué sigue?

• Obtén información sobre la configuración predeterminada y personalizada del Agente de operaciones. Consulta Configura el Agente de operaciones.