Usando os comandos drupal-config

É possível usar os comandos drupal-config para listar, obter os valores, configurar valores, criar novos e excluir os objetos de configuração Drupal em seu serviço do Portal do Desenvolvedor .

Por exemplo, é possível usar os comandos drupal-config para desativar a agregação CSS e JS para ajudar na depuração de ramificação, consulte Exemplo.

Efetue login como organização do Provedor:
```
apic login --server management_server --realm provider/identity_provider --username provider_username --password provider_password
```
É possível determinar qual provedor de identidade usar no parâmetro --realm inserindo o comando a seguir para ver uma lista de todos os provedores de identidade disponíveis (não é necessário estar conectado para usar este comando):
```
apic identity-providers:list --scope provider --server platform_api_endpoint_url --fields title,realm
```
Por exemplo,
```
apic identity-providers:list --scope provider --server platform_api_endpoint_url --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
```
O valor title deve permitir que você determine qual provedor de identidade usar; será possível, então, copiar o parâmetro --realm correspondente diretamente do valor realm exibido. Para todos os provedores de identidade que o administrador criou após a instalação do API Connect , os nomes são determinados no momento da criação. O Registro do usuário local do API Manager padrão para efetuar login como um membro de uma organização do provedor é default-idp-2.
Para obter detalhes completos do comando apic login , consulte Efetuando login em um servidor de gerenciamento..

Listar todas as configurações do Drupal disponíveis para um site

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

management_server é o URL do ponto de extremidade do servidor de gerenciamento (obrigatório).
catalogid/name é o ID ou nome do catálogo ao qual o site pertence (obrigatório).
orgid/name é o ID ou o nome da organização do provedor à qual o catálogo pertence (obrigatório)
format_type é o formato de saída.. Pode ser json, yaml, go-template=..., go-template-file=.... O padrão é yaml.

Por exemplo:

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
...

Observe que o exemplo foi reduzido porque a resposta integral é muito grande.

Listar uma configuração específica do Drupal para um site

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

config_prefix é o prefixo da configuração Drupal , por exemplo system. Se omitido, o comando retorna todos os nomes de configuração no sistema.

Por exemplo:

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

Atualize um valor de chave de configuração 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 é o nome do objeto de configuração Drupal , por exemplo system.site (necessário).
config_key é a chave de configuração Drupal , por exemplo page.front (necessário).
config_value é o valor a ser designado à chave de configuração (necessário).

Por exemplo, para configurar o tema padrão para 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.

Crie uma nova chave de configuração Drupal e configure o 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 exemplo, para criar uma nova chave de configuração e configurar o valor no objeto de configuração 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.

Obter todos os valores de chave para um objeto de configuração Drupal .

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

Por exemplo, para descobrir quais temas estão disponíveis:

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"
}

Obtenha o valor de uma chave específica para um objeto de configuração 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 exemplo, para descobrir qual é o tema padrão:

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"
}

Excluir um objeto de configuração Drupal ou uma chave de configuração específica e seu 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 é a chave de configuração Drupal , por exemplo page.front (opcional).

Por exemplo, para excluir a chave de configuração new_key e seu 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.

Exemplo

O cenário a seguir fornece um exemplo de como desativar a agregação CSS e JS para ajudar com a depuração de twig. No entanto, em uma agregação do sistema de produção, deve ser ativado por motivos de desempenho

Verifique as configurações para desempenho, que incluem configurações para agregação CSS e JS:

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

Desative a agregação 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

Desative a agregação 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

Em seguida, reconstrua o cache:

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

Ao carregar o site em um navegador, agora você deve ver que a agregação CSS e JS está desativada ao usar ferramentas de desenvolvimento para depuração ou customização do site.

Nota:

Desativar a agregação afeta o desempenho do site, portanto, se o site entrar em produção, lembre-se de ativar a agregação novamente.
Embora as configurações sejam mostradas como true ou false, para configurá-las usando o comando drupal-config:set , você deve aplicar um valor de 1 para truee 0 para false.