Criar destinos usando o espaço de trabalho Subordinados

Saiba como criar e gerenciar seus grupos de destino usando o espaço de trabalho Subordinados no SaltStack Config.

Criando um novo destino

Cada destino no SaltStack Config requer um nome, um mestre Salt e critérios de destino. Para definir um novo destino, incluindo um ou mais subordinados:

1. No espaço de trabalho Subordinados, clique em Todos os Subordinados no painel lateral Destinos.
2. Clique no botão Criar destino.
3. Na caixa de diálogo Criar destino, no campo Nome, insira um nome descritivo para o novo destino.
4. Por padrão, a configuração Todos os mestres está ativada, o que significa que os subordinados que estão sendo gerenciados por qualquer mestre Salt podem ser incluídos no destino. Clique neste botão para aplicar esse destino apenas a um subconjunto de subordinados associados a um ou mais mestres Salt.

   Se você desabilitar essa configuração, será exibido um menu que pode ser usado para selecionar as quais mestres Salt aplicar o destino. Consulte Descrição das configurações para obter mais informações.

5. Clique no menu Grain e selecione o tipo de destino que você deseja usar. É possível definir subordinados como destino usando grains, globs, lists ou compounds. Consulte Configurações de destinos para obter mais informações sobre essas opções de destino. Para obter informações mais gerais sobre definição de destinos com o Salt, consulte Definindo subordinados como destino.
   Diferentes configurações de destino, critérios e critérios estão disponíveis com base no tipo de destino selecionado na etapa anterior. Para obter mais informações sobre essas configurações, consulte Configurações de destinos.

   Observação: Se você selecionar Compound como o primeiro critério, deverá seguir a sintaxe de destino incluída na Referência para definição de destinos no Salt e incluir quaisquer critérios secundários na definição de destino composto. O SaltStack Config não permite adicionar outros critérios no editor de destinos. Para obter mais informações sobre destinos compostos, consulte Configurações de destinos.
6. Quando terminar, clique em Salvar.

Seu novo destino aparece na lista de destinos no espaço de trabalho Subordinados.

Criando um destino de lista simples

Para criar um novo destino usando uma lista simples:

1. No espaço de trabalho Subordinados, clique em Todos os Subordinados no painel lateral Destinos.
2. Clique na caixa de seleção ao lado dos subordinados que você deseja incluir na lista e clique em Criar destino.
   Observação: Filtrar ou classificar seus subordinados pode ser útil para definir uma lista. "A lista selecionada, conforme incluído como critério."
3. Insira um nome de destino e defina quaisquer configurações de destino adicionais. Consulte Descrição das configurações para obter mais informações.
4. Quando terminar, clique em Salvar.

Atribuindo um pilar a um destino

Pilares são usados principalmente para armazenar segredos ou outros dados altamente confidenciais, como credenciais de contas, chaves criptográficas ou senhas. Pilares também são úteis para armazenar dados não secretos que você não deseja colocar diretamente nos seus arquivos de estado, como dados de configuração. Para atribuir dados de pilares a um grupo de destino específico:

1. No espaço de trabalho Subordinados, selecione um destino no painel lateral Destinos.
2. Clique em Mais ações.
3. No menu, clique em Anexar Pilar.
4. Na caixa de diálogo, selecione os pilares que você deseja aplicar ao destino.

   Além de selecionar um pilar, selecione Atualizar pilar para disponibilizar esse pilar ao destino selecionado imediatamente.

5. Clique em Atualizar Destino.
   Os dados de pilares selecionados agora estão disponíveis para todos os subordinados no destino.

   Observação: Você também pode atribuir um pilar a um destino no espaço de trabalho Pilares. Para obter mais informações, consulte Como criar arquivos de estado e dados de pilares.

Configurações de destinos

A definição de destinos no SaltStack Config é semelhante à definição de destinos no Salt de código aberto, mas o SaltStack Config tem uma interface simplificada para definir destinos, o que também permite salvar definições de destinos para reutilização. Para obter mais informações sobre a definição de destinos no Salt, consulte Referência para definição de destinos no Salt.

Cada destino no SaltStack Config inclui um nome, um mestre Salt e critérios de destino, como mostra a tabela a seguir.

Configuração	Descrição
Nome	Insira um nome de destino. Nomes de destino não precisam ser exclusivos. Isso pode resultar na exibição de itens diferentes com o mesmo nome na interface do usuário do SaltStack Config.
Todos os mestres Salt	Por padrão, o destino inclui todos os mestres Salt. No entanto, você pode optar por definir como destino subordinados que pertencem apenas a um mestre Salt específico. Por exemplo, se o seu ambiente tiver vários nós responsáveis pela execução de um aplicativo específico e você tiver particionado sua infraestrutura Salt para que essas máquinas estejam todas conectadas a um único mestre Salt, será possível selecionar apenas o mestre Salt para criar um destino que inclua o subconjunto inteiro de subordinados. Para ativar destinos por mestre Salt, clique no botão de opção para desativar essa configuração. Um novo grupo de configurações é exibido. No campo Mestre, selecione um mestre Salt cujos subordinados você deseja definir como destinos. Todos os critérios de destino adicionais são aplicados apenas ao subconjunto de subordinados associados ao mestre Salt selecionado.
Critérios de destinos	Destinos são dinâmicos, e novos subordinados são adicionados automaticamente a qualquer definição de destino correspondente. Se você não quiser incluir novos subordinados que possam corresponder ao destino dinâmico no futuro, salve seu destino como uma lista em vez disso.

É possível usar critérios de destino para especificar um grupo de subordinados, fazendo referência às seguintes descrições de campos.

Tipo de destino	Descrição
Grain	Corresponde um valor específico de grain, por exemplo, osfullname é Debian. Depois que você selecionar um grain, a lista de valores será pré-preenchida para que você possa começar a digitar ou clicar no campo e visualizar as opções disponíveis.
Glob	Faz a correspondência por caracteres curinga usando o ID do subordinado. Por exemplo, você pode inserir webserver* para selecionar vários subordinados com os nomes webserver01, webserver02 e webserver03.
List	Especifique uma lista de subordinados a serem incluídos no destino. Por exemplo, dc3-north-db1,dc3-north-db2. Especificar uma lista é útil quando você não deseja conceder acesso a destinos dinamicamente. Isso evita que novos subordinados que correspondam aos critérios dinâmicos de destino sejam adicionados automaticamente a um destino.
Compound	Combina várias interfaces de destino separadas por conjunções e, ou, e não. Se você selecionar Compound como o primeiro critério, deverá seguir a sintaxe de destino incluída na Referência para definição de destinos no Salt e incluir quaisquer critérios secundários na definição de destino composto. O SaltStack Config não permite adicionar outros critérios no editor de destinos.

Próximas etapas

Depois de criar os destinos necessários, você poderá criar trabalhos que executarão tarefas e processos com base nos subordinados definidos como destino. Consulte Como criar trabalhos para obter mais informações.