Configurando App Configuration

DevOps Insights chegará ao fim de sua vida útil e será descontinuado em 31 de agosto de 2026. O serviço Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-tor, us-east. O Code Risk Analyzer também será descontinuado em todas as regiões nessa data. Se uma região não apresentar uso ativo desses recursos, os recursos nessa região poderão ser descontinuados antecipadamente e deixar de aceitar novas instâncias. Saiba mais

O IBM Cloud® App Configuration é um serviço centralizado de gerenciamento e configuração de recursos que fornece uma abordagem conveniente, consistente e segura para acessar, referenciar e reutilizar coleções de sinalizações e propriedades de recursos dentro de cadeias de ferramentas.

É possível configurar uma instância do App Configuration utilizando o painel da instância de serviço do App Configuration para incluir e gerenciar ambientes e coleções específicas que contêm conjuntos de sinalizações e propriedades de recursos. É possível refinar ainda mais o uso de sinalizações e propriedades de recursos, especificando segmentos de destino que são avaliados com base em atributos e regras de usuários.

Também é possível incluir uma integração de ferramenta do App Configuration em uma cadeia de ferramentas e aplicar sinalizações ou propriedades específicas de recursos da instância de serviço para as propriedades de ambiente ou de acionador do pipeline associado. É possível repetir esse processo em várias cadeias de ferramentas, utilizando instâncias de serviço do App Configuration, conforme necessário. Por exemplo, é possível usar uma instância de serviço para armazenar e gerenciar centralmente todas as sinalizações e propriedades de recursos necessárias para as cadeias de ferramentas em vários ambientes.

Ao aplicar sinalizações e propriedades de recursos em uma cadeia de ferramentas, as referências especiais de sinalização e de propriedade do recurso App Configuration são salvas na cadeia de ferramentas, em vez de nos valores literais. Esse recurso suporta o gerenciamento centralizado de sinalizações e propriedades de recursos diretamente a partir de uma instância de serviço do App Configuration. Os valores das sinalizações e propriedades de recursos ficam, então, imediatamente disponíveis para as cadeias de ferramentas que contêm referências a esses valores de sinalizações e propriedades de recursos durante as execuções subsequentes do pipeline.

Criando uma integração do App Configuration

Antes de criar uma integração da ferramenta App Configuration em sua cadeia de ferramentas, certifique-se de fornecer uma instância do serviço App Configuration em uma região e um grupo de recursos que possam ser referenciados pela cadeia de ferramentas.

  1. Se você estiver configurando essa integração de ferramenta durante a criação da cadeia de ferramentas e houver uma integração da ferramenta App Configuration no modelo que está sendo configurado, clique na guia App Configuration. Como alternativa, na seção Mais ferramentas, clique em App Configuration. Para criar uma autorização entre a cadeia de ferramentas e a instância de serviço App Configuration, selecione a opção Criar uma autorização para essa cadeia de ferramentas na lista suspensa Tipo de autorização. Isso concede acesso à cadeia de ferramentas para as sinalizações de recurso e propriedades armazenadas na instância de serviço do App Configuration.

  2. Se você já possui uma cadeia de ferramentas e deseja adicionar essa integração de ferramenta a ela, no console do IBM Cloud, clique no ícone de menu ( ícone de hambúrguer ) > Automação de Plataforma > Cadeias de Ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas existente para abrir sua página Visão geral

    a. Clique em Incluir ferramenta.

    b. Na seção Integrações de ferramentas, clique em App Configuration.

  3. Digite o nome que deseja exibir para essa nova integração de ferramenta no cartão do App Configuration na cadeia de ferramentas. Este nome é usado para identificar a integração da ferramentas em sua cadeia de ferramentas.

  4. Selecione a Região e o Grupo de recursos nos quais a instância de serviço do App Configuration existe.

  5. Selecione as opções corretas de Ambiente de App Configuration e Coleção de App Configuration a partir da instância de serviço do App Configuration escolhida.

  6. Para criar uma autorização entre a cadeia de ferramentas e a instância de serviço App Configuration, clique no botão Criar autorização. Isso concede acesso à cadeia de ferramentas para as sinalizações de recurso e propriedades armazenadas na instância de serviço do App Configuration.

  7. Clique em Criar integração.

Aplicando sinalizações e propriedades de recursos

Depois de configurar a integração da ferramenta App Configuration, é possível utilizá-la para aplicar sinalizações e propriedades de recursos para as propriedades de ambiente e de acionador da cadeia de ferramentas.

  1. Na guia Propriedades de ambiente do pipeline ou na guia Propriedades do acionador, clique em Incluir para exibir a lista de tipos de propriedades disponíveis.

  2. Selecione Valor de AppConfig e escolha as sinalizações ou propriedades de recursos que deseja aplicar nas propriedades de ambiente e de acionador da cadeia de ferramentas.

  3. Especifique o nome para a nova propriedade de ambiente ou de acionador da cadeia de ferramentas.

  4. Selecione a integração da ferramenta App Configuration e, a partir dela, escolha Ambiente e Coleção.

  5. Selecione Sinalizador de recurso ou Propriedade e, a partir da lista na instância de serviço do App Configuration, escolha a sinalização ou propriedade de recurso de destino.

  6. Clique em OK para aplicar uma referência de App Configuration no campo que está associado a ele.

Autorizando a cadeia de ferramentas a acessar sinalizações e propriedades de recursos

As referências às sinalizações e propriedades de recursos armazenadas em uma instância de serviço do App Configuration são resolvidas dinamicamente quando a cadeia de ferramentas é executada. Para acessar as sinalizações e propriedades de recursos necessárias, você deve autorizar a cadeia de ferramentas a acessar a instância do App Configuration. Se você estiver criando uma cadeia de ferramentas a partir de um modelo, use a lista suspensa Tipo de autorização ao configurar a App Configuration integração. Se você estiver incluindo uma integração do App Configuration em uma cadeia de ferramentas existente, use o botão Criar autorização.

Para visualizar as suas autorizações na IBM Cloud, conclua as etapas a seguir:

  1. No console do IBM Cloud, clique em Gerenciar > Acesso (IAM).
  2. Clique em Autorizações.

Você também pode acessar suas autorizações na página “Gerenciar autorizações ”.

Se necessário, também é possível criar a autorização manualmente. Para que as referências de App Configuration sejam resolvidas com êxito, a cadeia de ferramentas deve ter acesso de Viewer e de Reader para a instância de serviço correta do App Configuration.

Configurando o App Configuration por meio da API

A integração de App Configuration ferramentas suporta os seguintes parâmetros de configuração que você pode usar com a API e os SDKs HTTP da Toolchain ao criar, ler e atualizar integrações de ferramentas.

Você deve especificar a propriedade tool_type_id no corpo da solicitação com o valor appconfig.

parâmetros de integração da ferramentaApp Configuration
Parâmetro Uso Tipo Argumento de Terraform Descrição
coleção-nome necessário, atualizável Sequência collection_id O ID da coleção “ App Configuration ”.
ambiente-nome necessário, atualizável Sequência environment_id O ID do ambiente App Configuration.
instance-name necessário, atualizável Sequência instance_id O guid da instância de serviço App Configuration.
nome necessário, atualizável Sequência nome O nome dessa integração de ferramenta. App Configuration referências incluem este nome para identificar a instância App Configuration onde os valores de configuração residem. Certise-se de que cada uma das ferramentas App Configuration que estão integradas em uma cadeia de ferramentas possuem um nome exclusivo para resolução para funcionar adequadamente.
região necessário, atualizável Sequência local O local IBM Cloud onde a instância de serviço App Configuration está localizada.
grupo de recursos necessário, atualizável Sequência resource_group_name O nome do grupo de recursos onde está localizada a instância de serviço App Configuration.

Saiba mais sobre o App Configuration

Para saber mais sobre o App Configuration, consulte Introdução ao App Configuration.