Puedes usar la Configuración de recursos para configurar de forma centralizada la configuración de los proyectos, las carpetas y la organización de Google Cloud. Esta configuración la heredan sus elementos subordinados de la jerarquía de recursos. Google crea y administra cada parámetro de configuración.
Configuración de recursos
La configuración de recursos representa una dimensión de un recurso o servicio de Google Cloud que puedes configurar. Por ejemplo, una configuración de ubicación de creación de buckets de Cloud Storage podría determinar la ubicación predeterminada en la que se crean los recursos de buckets nuevos.
Cada parámetro de configuración de recursos tiene las siguientes propiedades clave:
Nombre: Un identificador global único para la configuración que se usa en la configuración de los valores de un parámetro.
Metadatos: La información administrada por Google sobre la configuración de recursos. Los metadatos de una configuración de recursos incluyen los siguientes campos:
Tipo de datos: Es el tipo de valores que se pueden configurar para este parámetro de configuración. Entre los tipos de datos posibles, se incluyen booleanos, cadenas, conjuntos de cadenas y enumeraciones.
Valor predeterminado: El valor predeterminado administrado por Google del parámetro de configuración si no se configura otro valor dentro de la organización.
Solo lectura: Una marca que indica si Google hizo que esta configuración sea de solo lectura. Si una configuración de recursos es de solo lectura, no se pueden modificar los valores de esta configuración. Una configuración es de solo lectura para las migraciones y las bajas. Google proporciona una advertencia antes de realizar un cambio a esta marca.
Valor local: El valor específico de una configuración asociada con un recurso.
Valor efectivo: Es el valor de una configuración después de evaluar la configuración de recursos heredados de la jerarquía de recursos.
Necesitas la función Visualizador de configuración de recursos o Administrador de configuración de recursos de Identity and Access Management para ver la lista de opciones de configuración disponibles para usar en una organización, carpeta o proyecto determinados. Para obtener más detalles sobre estos roles, consulta Permisos necesarios.
La disponibilidad de la configuración de recursos puede variar entre organizaciones según el estado de lanzamiento de la configuración de recursos.
Ejemplo de configuración de recursos
A continuación, se muestra un ejemplo de cómo aparece una configuración de recursos:
# Setting
{
"name": "net-preferredDnsServers",
"metadata": {
"displayName": "Preferred DNS Servers",
"description": "The DNS servers to be used by VMs associated with this resource.",
"read_only": false,
"data_type" : "STRING_SET",
"default_value" : {
"string_set_value" : {
"values" : [ "8.8.8.8" ],
}
}
}
}
Nombre
Una configuración de recursos tiene un nombre corto global único, en el formato settings/SETTING_ID. Por ejemplo, el nombre corto de una configuración de recursos para controlar la imagen de inicio inicial de una máquina virtual podría ser settings/compute-vmStartupImage.
El nombre del recurso relativo de un parámetro de configuración agrega el ID de recurso numérico al nombre corto de la configuración. Por ejemplo, el nombre del recurso relativo de la configuración de settings/compute-vmStartupImage anterior para organizations/12345678901 es organizations/12345678901/settings/compute-vmStartupImage.
Los parámetros de configuración que tienen el mismo nombre corto se consideran idénticos en Google Cloud, incluso si tienen diferentes nombres de recursos relativos. El recurso incluido en un nombre de recurso relativo solo denota la disponibilidad de esa configuración para el recurso nombrado.
Valores de configuración locales
El valor de configuración que se aplica directamente a la configuración de un recurso en particular se denomina valor de configuración local. Puedes modificar directamente el valor local de una configuración de recursos con la API de Resource Settings.
A continuación, se muestra un ejemplo de configuración de recursos que incluye un valor de configuración local:
# Setting
{
"name" : "folders/123/settings/net-preferredDnsServers"
"localValue": {
"stringSetValue": {
"values": ["8.8.8.8", "8.8.4.4"]
}
}
}
Valores de configuración efectivos
Todos los elementos subordinados de ese recurso heredan el valor de la configuración local de un recurso en la jerarquía de recursos. Si uno de estos elementos subordinados tiene un valor de configuración local, este anula el valor de configuración heredado. Si no estableciste un valor de configuración local en un recurso o en ninguno de sus subordinados, se usa el valor predeterminado que define Google para esa configuración.
Se evalúa la configuración de los recursos y el resultado es el valor de configuración efectivo. Este valor muestra el resultado final de toda la configuración de valores locales y herencia para un recurso determinado. Las reglas para determinar el valor de configuración efectivo se evalúan de la siguiente manera:
Si un recurso tiene un valor para una configuración de recurso determinada, ese es el valor real y anula cualquier valor heredado.
Si el recurso no tiene un valor para esta configuración de recursos, si alguno de los principales del recurso tiene un valor para esa configuración, el valor asociado con el principal más cercano es el valor efectivo.
Si ni este recurso ni sus principales tienen un valor para esta configuración de recursos, y la configuración tiene una configuración predeterminada administrada por Google, ese es el valor real.
Si ni el recurso ni sus principales tienen un valor para esta configuración de recursos y el valor no tiene un valor predeterminado administrado por Google, no hay un valor efectivo para esta configuración en este recurso.
Configuración de recursos sin valor efectivo
Si una configuración de recursos no tiene un valor predeterminado administrado por Google, es posible tener un recurso que no tenga un valor efectivo para esa configuración. La nueva configuración de recursos no tiene los valores predeterminados administrados por Google si es posible hacerlo de manera retrocompatible. Por lo tanto, las configuraciones nuevas no interrumpen los servicios existentes.
Valores vacíos y valores no establecidos
Un valor de configuración de recursos se considera vacío si tiene un valor de configuración de recursos vacío. Por ejemplo, "" es una cadena vacía. Los valores vacíos se consideran valores de acuerdo con la evaluación de los valores de configuración efectivos y anulan la herencia.
Si no se establece ningún valor local, la configuración de recursos permanece sin establecer; este recurso hereda el valor de configuración del recurso.
¿Qué sigue?
- Para obtener más información, consulta Administra la configuración de recursos.