Puedes usar la configuración de recursos para configurar de forma centralizada la configuración de tus proyectos, carpetas y organización de Google Cloud. Sus descendientes en la jerarquía de recursos heredan esta configuración. 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: Es la información administrada por Google sobre la configuración de los recursos. Los metadatos de la configuración de un recurso incluyen los siguientes campos:
Tipo de datos: Es el tipo de valores que se pueden configurar para este parámetro de configuración. Los tipos de datos posibles incluyen valores booleanos, cadenas, conjuntos de cadenas y enumeraciones.
Valor predeterminado: Es el valor predeterminado del parámetro de configuración administrado por Google si no se establece ningún otro valor en tu organización.
Solo lectura: Es una marca que indica si Google estableció este parámetro de configuración como de solo lectura. Si un parámetro de configuración de recursos es de solo lectura, los valores de este parámetro no se pueden modificar. Un parámetro de configuración solo se establece como de solo lectura para las migraciones y las baja. Google proporciona una advertencia antes de realizar un cambio en esta marca.
Valor local: El valor específico de una configuración asociada con un recurso.
Valor efectivo: Es el valor de un parámetro de configuración después de evaluar la configuración de recursos heredada de la jerarquía de recursos.
Necesitas el rol de Identity and Access Management de Visualizador de configuración de recursos o Administrador de configuración de recursos para ver la lista de parámetros 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 diferir entre organizaciones, según el estado de lanzamiento de la configuración de recursos.
Ejemplo de configuración de recursos
El siguiente es un ejemplo de cómo aparece un parámetro de 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
La configuración de un recurso tiene un nombre corto único a nivel global, 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 de recurso relativo de un parámetro de configuración agrega el ID de recurso numérico al nombre corto del parámetro. Por ejemplo, el nombre de recurso relativo de la configuración de settings/compute-vmStartupImage anterior para organizations/12345678901 es organizations/12345678901/settings/compute-vmStartupImage.
Google Cloud considera que los parámetros de configuración que tienen el mismo nombre corto son idénticos, incluso si tienen diferentes nombres de recursos relativos. El recurso incluido en un nombre de recurso relativo solo indica la disponibilidad de ese parámetro de configuración para el recurso nombrado.
Valores de configuración locales
El valor de configuración que se aplica directamente a una configuración de recursos en particular se llama valor de configuración local. Puedes modificar directamente el valor local de la configuración de un recurso con la API de Resource Settings.
El siguiente es 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 descendientes de un recurso en la jerarquía de recursos heredan el valor de configuración local de ese recurso. Si uno de estos elementos secundarios tiene un valor de configuración local, se anula el valor de configuración heredado. Si no estableciste un valor de configuración local en un recurso o en cualquiera de sus elementos secundarios, se usará el valor predeterminado definido por Google para ese parámetro de configuración.
Se evalúa la configuración de recursos y el resultado es el valor de configuración efectivo. Este valor muestra el resultado final de toda la configuración de herencia y valor local en 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 recursos determinada, ese es el valor efectivo, que anula cualquier valor heredado.
Si el recurso no tiene un valor para este parámetro de configuración, si alguno de los ancestros del recurso tiene un valor para ese parámetro, el valor asociado con el ancestro más cercano es el valor efectivo.
Si ni este recurso ni sus ancestros tienen un valor para esta configuración de recursos, y la configuración tiene un valor predeterminado administrado por Google, ese es el valor efectivo.
Si ni el recurso ni sus ancestros tienen un valor para esta configuración de recursos, y el valor no tiene un valor predeterminado administrado por Google, entonces no hay un valor efectivo para este parámetro de configuración en este recurso.
Configuración de recursos sin valor vigente
Si un parámetro de configuración de recursos no tiene un valor predeterminado administrado por Google, es posible que haya un recurso que no tenga un valor efectivo para ese parámetro de configuración. La configuración de recursos nuevos no tiene valores predeterminados administrados por Google si es posible hacerlo de forma retrocompatible. Por lo tanto, la configuración nueva no interrumpe 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 que es vacío. Por ejemplo, "" es una cadena vacía. Los valores vacíos aún se consideran valores según la evaluación de los valores de configuración efectivos y anula 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.