Utilización de los mandatos drupal-config

Puedes utilizar los comandos ' drupal-config ' para listar, obtener los valores de, establecer valores, crear nuevos, y borrar los objetos de configuración de Drupal en tu servicio del Portal del Desarrollador.

Por ejemplo, puede utilizar los mandatos drupal-config para inhabilitar la agregación CSS y JS para ayudar con la depuración de twig, consulte Ejemplo.

Iniciar sesión como organización de proveedores:
```
apic login --server management_server --realm provider/identity_provider --username provider_username --password provider_password
```
Puede determinar qué proveedor de identidad usar en el parámetro --realm especificando el comando siguiente para ver la lista de todos los proveedores de identidad disponibles (no es necesario iniciar sesión para ejecutar este comando):
```
apic identity-providers:list --scope provider --server platform_api_host_name --fields title,realm
```
Por ejemplo:
```
apic identity-providers:list --scope provider --server platform_api_host_name --fields title,realm 
total_results: 2
results:
  - title: API Manager User Registry
    realm: provider/default-idp-2
  - title: Corporate LDAP user registry
    realm: provider/corporate-ldap
```
El valor title debería permitirle determinar qué proveedor de identidad utilizar; a continuación, puede copiar el parámetro --realm correspondiente directamente desde el valor realm visualizado. Para los proveedores de identidad creados por el administrador después de instalar API Connect , los nombres se habrán determinado en el momento de la creación. El registro de usuarios local predeterminado del gestor de API para iniciar sesión como miembro de una organización de proveedores es default-idp-2.
Para obtener todos los detalles del mandato apic login , consulte Inicio de sesión en un servidor de gestión.

Listar todas las configuraciones de Drupal disponibles para un sitio.

apic --mode portaladmin drupal-config:list --server management_server --catalog catalogid/name --org orgid/name --format format_type

management_server es la URL del endpoint del servidor de gestión (obligatorio).
catalogid/name es el ID o nombre del catálogo al que pertenece el sitio (obligatorio).
orgid/name es el ID o nombre de la organización de proveedores a la que pertenece el catálogo (obligatorio).
format_type es el formato de salida. Puede ser json, yaml, go-template=..., go-template-file=.... El valor predeterminado es yaml.

Por ejemplo:

apic --mode portaladmin drupal-config:list --server my.management.server.com --org ibm --catalog portal-test --format yaml
admin_toolbar_tools.settings:
  name: admin_toolbar_tools.settings
adminimal_admin_toolbar.settings:
  name: adminimal_admin_toolbar.settings
advagg.settings:
  name: advagg.settings
advagg_css_minify.settings:
  name: advagg_css_minify.settings
advagg_js_minify.settings:
  name: advagg_js_minify.settings
autologout.settings:
  name: autologout.settings
...

Tenga en cuenta que el ejemplo se ha reducido ya que la respuesta completa es muy grande.

Listar una configuración de Drupal específica para un sitio.

apic --mode portaladmin drupal-config:list --server management_server --catalog catalogid/name --org orgid/name --prefix config_prefix --format format_type

config_prefix es el prefijo de la configuración Drupal , por ejemplo system. Si se omite, el mandato devuelve todos los nombres de configuración del sistema.

Por ejemplo:

apic --mode portaladmin drupal-config:list --server my.management.server.com --org ibm --catalog portal-test --format yaml --prefix system.theme
system.theme:
  name: system.theme
system.theme.global:
  name: system.theme.global

Actualice un valor de clave de configuración Drupal .

apic --mode portaladmin drupal-config:set -server management_server --catalog catalogid/name --org orgid/name  --config_name config_name --config_key config_key --config_value config_value

config_name es el nombre del objeto de configuración Drupal , por ejemplo system.site (obligatorio).
config_key es la clave de configuración Drupal , por ejemplo page.front (obligatorio).
config_value es el valor que se asigna a la clave de configuración (obligatorio).

Por ejemplo, para establecer el tema predeterminado en claro:

apic --mode portaladmin drupal-config:set --server my.management.server.com --org ibm --catalog portal-test --config_name system.theme --config_key default --config_value claro
// Do you want to update default key in system.theme config?: yes.

Cree una nueva clave de configuración Drupal y establezca el valor.

apic --mode portaladmin drupal-config:set -server management_server --catalog catalogid/name --org orgid/name  --config_name config_name --config_key new_config_key --config_value new_config_value

Por ejemplo, para crear una nueva clave de configuración y establecer el valor en el objeto de configuración system.site :

apic --mode portaladmin drupal-config:set --server my.management.server.com --org ibm --catalog portal-test --config_name system.site --config_key new_key --config_value new_value
// new_key key does not exist in system.site config. Do you want to create a new config key?: yes.

Obtener todos los valores de clave para un objeto de configuración Drupal .

apic --mode portaladmin drupal-config:get --server management_server --catalog catalogid/name --org orgid/name  --format format_type --config_name config_name

Por ejemplo, para averiguar qué temas están disponibles:

apic --mode portaladmin drupal-config:get --server my.management.server.com --org ibm --catalog portal-test --format json --config_name system.theme
{
    "admin": "seven",
    "default": "claro",
    "_core": {
        "default_config_hash": "fOjer9hADYYnbCJVZMFZIIM1azTFWyg84ZkFDHfAbUg"
    },
    "defaultplus": "bartisk"
}

Obtener el valor de una clave específica para un objeto de configuración Drupal .

apic --mode portaladmin drupal-config:get --server management_server --catalog catalogid/name --org orgid/name  --format format_type --config_name config_name --config_key config_key

Por ejemplo, para averiguar cuál es el tema predeterminado:

apic --mode portaladmin drupal-config:get --server my.management.server.com --org ibm --catalog portal-test --format json --config_name system.theme --config_key default
{
    "system.theme:default": "claro"
}

Suprimir un objeto de configuración Drupal o una clave de configuración específica y su valor.

apic --mode portaladmin drupal-config:delete --server management_server --catalog catalogid/name --org orgid/name  --config_name config_name --config_key config_key

config_key es la clave de configuración Drupal , por ejemplo page.front (opcional).

Por ejemplo, para suprimir la clave de configuración new_key y su valor:

apic --mode portaladmin drupal-config:delete --server my.management.server.com --org ibm --catalog portal-test --config_name system.site --config_key new_key
The config object/value was successfully deleted.

Ejemplo

El escenario siguiente proporciona un ejemplo de cómo desactivar la agregación CSS y JS para ayudar con la depuración de twig. Sin embargo, en un sistema de producción, la agregación debe estar habilitada por motivos de rendimiento.

Compruebe los valores de rendimiento, que incluyen valores para la agregación CSS y JS:

apic --mode portaladmin drupal-config:get --server management_server --catalog catalogid/name --org orgid/name --config_name system.performance

Desactivar agregación CSS:

apic --mode portaladmin drupal-config:set --server management_server --catalog catalogid/name --org orgid/name --config_name system.performance --config_key css.preprocess --config_value 0

Desactivar agregación JS:

apic --mode portaladmin drupal-config:set --server management_server --catalog catalogid/name --org orgid/name --config_name system.performance --config_key js.preprocess --config_value 0

A continuación, vuelva a crear la memoria caché:

apic --mode portaladmin site:cache-rebuild  --server management_server --catalog catalogid/name --org orgid/name

Al cargar el sitio en un navegador, ahora debería ver que la agregación CSS y JS está inhabilitada cuando se utilizan herramientas de desarrollo para la depuración o personalización del sitio.

Nota:

La inhabilitación de la agregación afecta al rendimiento del sitio, por lo que si el sitio entra en producción, recuerde volver a activar la agregación.
Aunque los valores se muestran como true o false, para establecerlos utilizando el mandato drupal-config:set , debe aplicar un valor de 1 para truey 0 para false.