Uso do console para criar a definição da pilha

Em um projeto, sua definição de pilha é criada automaticamente quando você empilha arquiteturas implementáveis e define variáveis. Usar o console para empilhar arquiteturas implantáveis e definir variáveis de pilha oferece os seguintes benefícios:

• Você pode usar o seletor de referência no console para criar referências entre arquiteturas implantáveis empilhadas, em vez de escrever as referências do zero.
• A implementação das arquiteturas empilhadas de um projeto ajuda a verificar se a solução geral funciona conforme projetado antes que outras pessoas a configurem e implementem.
• Como a definição da pilha é criada automaticamente com base nas seleções no console, informações como IDs do localizador de versão de arquiteturas implantáveis de membros são precisas e atualizadas automaticamente.

No projeto, você pode selecionar quais entradas deseja incluir no nível da pilha. Essas entradas são incluídas na seção inputs da definição de pilha e são configuradas como referências na arquitetura implantável do membro em seu projeto. Na imagem a seguir, a entrada prefix é destacada dentro da arquitetura implantável do membro Custom Apache. Se esta entrada for selecionada, o Default value muda para uma referência à entrada do nível de pilha. Quando um usuário adiciona sua solução a um projeto de um catálogo, ele pode configurar a entrada prefix e a arquitetura do membro Custom Apache fará referência a esse valor. A entrada fp_vsi_floating_ip_address faz referência a uma saída de outra arquitetura implementável de membro. Essa entrada não deve ser selecionada, pois essa referência vincula as arquiteturas dos membros. Essas entradas de arquiteturas de membros são incluídas na seção members do arquivo de definição de pilha.

Editando sua definição de pilha

Para editar sua definição de pilha localmente, conclua as seguintes etapas:

1. Conclua as etapas para empilhar arquiteturas implementáveis, definir variáveis de pilha e integrar as arquiteturas empilhadas a um catálogo privado.

   Configure e implemente as arquiteturas que estão empilhadas para verificar se a solução funciona conforme projetado antes de adicioná-la a um catálogo privado.

2. Depois que a arquitetura implementável for adicionada ao seu catálogo privado, você será levado à página Configurar versão no catálogo. A partir daí, clique no menu Ações > Gerar manifesto.

   Você também pode usar o método Obter uma definição de pilha da API de projetos ou o comando ibmcloud project stack-definition da CLI de projetos para exportar a definição de pilha.

3. Abra o arquivo stack_definition.json.

4. Usando a definição de exemplo como guia, edite as variáveis de entrada e saída.

5. Adicione o arquivo na pasta raiz do seu repositório de código-fonte.

Na próxima vez que você adicionar uma nova versão da sua solução ao catálogo, suas atualizações serão incluídas.

Exemplo de arquivo de definição

Recomenda-se usar um projeto para criar a definição de pilha para ajudar a garantir a precisão. No entanto, o trecho de código a seguir pode ser usado como modelo para criar a definição de pilha do zero:

{
   "inputs": [
      {
         "name": "Stack input 1",
         "type": "string",
         "hidden": false,
         "required": true,
         "default" : "Default value"
      },
      {
         "name": "Stack input 2",
         "type": "string",
         "hidden": false,
         "required": true
      }
   ],
   "outputs": [
      {
         "name": "Output 1 name",
         "value": "The reference to this output value"
      },
      {
         "name": "Output 2 name",
         "value": "The reference to this output value"
      }
   ],
   "members": [
      {
         "Name": "Deployable architecture 1 name",
         "Version_locator": "",
         "inputs": [
            {
               "name": "Input 1 name",
               "value": "reference"
            },
            {
               "name": "Input 2 name",
               "value": "reference"
            }
         ]
      },
      {
         "Name": "Deployable architecture 2 name",
         "Version_locator": "",
         "inputs": [
            {
               "name": "Input 1 name",
               "value": "reference"
            },
            {
               "name": "Input 2 name",
               "value": "reference"
            }
         ]
      }
   ]
}

"inputs": [
   {
      "name": "Stack input 1",
      "type": "string",
      "hidden": false,
      "required": true,
      "default" : "Default value"
   },
   {
      "name": "Stack input 2",
      "type": "string",
      "hidden": false,
      "required": true
   }
]

"outputs": [
   {
      "name": "Output 1 name",
      "value": "The reference to this output value"
   },
   {
      "name": "Output 2 name",
      "value": "The reference to this output value"
   }
]

"members": [
   {
      "Name": "Deployable architecture 1 name",
      "Version_locator": "",
      "inputs": [
         {
            "name": "Input 1 name",
            "value": "reference"
         },
         {
            "name": "Input 2 name",
            "value": "reference"
         }
      ]
   }
]