Como criar destinos?

Definir destinos para trabalhos ou operações ajuda a impedir que as operações sejam executadas em nós que não devem executá-las. É possível organizar subordinados como destinos usando grains, globs, lists ou compounds.

O que é um destino?

Um destino é o grupo de subordinados, em um ou vários mestres Salt, ao qual o comando Salt de um trabalho se aplica. Destinos podem conter subordinados conectados a qualquer mestre Salt no seu ambiente. Um mestre Salt também pode ser gerenciado como um subordinado, podendo ser um destino se estiver executando o serviço de subordinados.

Você pode criar destinos para seus trabalhos no espaço de trabalho Subordinados. Por padrão, quando você abre o espaço de trabalho, o destino Todos os Subordinados fica ativo. O alvo Todos os Subordinados lista todos os subordinados que você tem permissão para acessar.

Antes de começar

Antes de criar seus destinos, você deve refletir sobre os grupos de destino que deseja criar. Por exemplo, você pode querer criar um grupo de destino para uma zona de segurança ou uma única sub-rede. A forma como você organiza seus grupos de destino dependerá das necessidades da sua organização.

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 destinos Salt, consulte Definindo subordinados como destino.
6. Diferentes configurações e critérios de destino 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.
7. 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 é incluída como critério.

3. Insira um nome de destino e defina quaisquer configurações de destino adicionais. Consulte Configurações de destinos.
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 destino específico de subordinados:

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, descritos em detalhes abaixo.

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. Ao criar destinos compostos usando grains, o RaaS não retorna subordinados se o nome do grain incluir um espaço. Por esse motivo, qualquer espaço é automaticamente convertido em um ?.
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	Combine várias interfaces de destino, separadas pelas 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. Para obter mais informações sobre destinos compostos, consulte Configurações de destinos.

Práticas recomendadas para a criação de destinos

Criar regras de destino simples

Embora não haja limite para quantos destinos você pode criar no SaltStack Config, tente criar as regras de destino mais simples que abrangem todas as máquinas nas quais você precisa realizar ações.

Identificar casos de uso necessários

Antes de criar destinos para seus trabalhos, comece com uma lista de casos de uso para ajudar você a determinar quais tipos de destino usar. Por exemplo, para aplicar patches, você pode usar grains para direcionar um sistema operacional específico. A tabela a seguir contém alguns exemplos de grupos de destino, casos de uso comuns e tipo de destino recomendado.

Grupo de destino	Caso de uso	Tipo de destino
Sistema operacional	Aplicação de patches Descoberta ou diagnóstico Conformidade com padrões	Grain
Cluster de aplicativos	Instalação de aplicativos Conformidade direcionada Aplicação seletiva de patches Detecção ou remediação de desvios e gerenciamento de configurações	Glob ou list
Centro de dados, sub-rede, zona de disponibilidade ou outro segmento de rede	Conformidade Configuração de rede ou regional	Glob ou grain personalizado
Método personalizado	Pacotes aprovados ou proibidos Gerenciamento de usuários com base na presença ou ausência de aplicativos instalados Contas de usuários	Grain personalizado

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.