O espaço de trabalho Subordinados é usado para visualizar detalhes de subordinados, procurar ou classificar subordinados por ID ou outras propriedades, executar comandos ou trabalhos assistemático e criar novos destinos. Você também pode usar esse espaço de trabalho para ajustar configurações de destino, como pilares anexados, executar trabalhos, aceitar ou rejeitar chaves, bem como atribuir uma função ou um pilar a um destino. Consulte Subordinados para obter mais informações.
Gerenciando subordinados e destinos
O espaço de trabalho Subordinados inclui uma lista de todos os subordinados Salt que estão executando o serviço de subordinados e que são gerenciados pelo SaltStack Config. Subordinados são nós que executam o serviço de subordinados e que podem ouvir comandos de um mestre Salt e executar as tarefas solicitadas. Os próprios mestres Salt podem executar o serviço de subordinados, o que torna possível configurar e gerenciar o nó executando o serviço de controlador Salt conforme necessário.
O painel lateral do espaço de trabalho inclui uma lista de destinos. Um destino é o grupo de subordinados, em um ou vários mestres Salt, ao qual o comando Salt de um trabalho se aplica. Um mestre Salt também pode ser gerenciado como um subordinado, podendo ser um destino se estiver executando o serviço de subordinados. Definir um destino para um trabalho ou operação também impede que essa operação seja executada em nós que não devem executá-la. Destinos podem conter subordinados conectados a qualquer mestre Salt no seu ambiente. É possível anexar dados de pilares a diferentes destinos. Pilares são estruturas de dados definidos no mestre Salt e transmitidas a um ou mais subordinados usando destinos. Eles permitem que dados confidenciais e direcionados sejam enviados com segurança apenas ao subordinado relevante. Consulte Pilares para obter mais informações.
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.
Trabalhos ou comandos assistemáticos
O espaço de trabalho Subordinados também inclui um controle Executar Comando, que permite executar um único comando assistemático em um ou mais subordinados sem criar um trabalho reutilizável. Esse recurso é útil para executar comandos rapidamente ou para executar trabalhos únicos que não fazem parte do seu fluxo de trabalho diário, por exemplo, ao solucionar problemas ou durante a configuração inicial. Consulte Executando um comando para obter mais informações.
No espaço de trabalho Subordinados, você pode executar um comando ou trabalho assistemático em:
- Um único subordinado
- Uma lista de subordinados
- Um mestre Salt ou todos os mestres Salt (usando salt-run)
- Um destino
Consulte Fluxo de trabalho de trabalhos do SaltStack Config para obter uma visão geral de como usar o espaço de trabalho Subordinados junto com os outros espaços de trabalho no SaltStack Config para criar e usar trabalhos para gerenciamento de configuração.
Acessando o espaço de trabalho Subordinados
Para usar o espaço de trabalho Subordinados, clique em Destinos no menu lateral.
Visualizando detalhes do subordinado
Para visualizar os detalhes de um subordinado específico:
- No espaço de trabalho Subordinados, selecione um ID de subordinado na coluna ID do Subordinado para abrir a página de detalhes do subordinado.
- Na página de detalhes do subordinado, é possível visualizar uma lista de grãos ou informações sobre o subordinado. Você também pode executar um trabalho assistemático com base em um único subordinado.
- Selecione a guia Atividade para visualizar o histórico de trabalhos do subordinado. Consulte Trabalhos para obter mais informações.
Baixando dados do subordinado
Para baixar dados de todos os subordinados:
- No espaço de trabalho Subordinados, clique em Mais ações para abrir um menu.
- No menu, em Baixar tabela, selecione o formato necessário para iniciar o download.
Procurando um subordinado
Para localizar um subordinado específico:
- No espaço de trabalho Subordinados, clique no botão de filtro
da coluna que você deseja pesquisar. - Comece a digitar os critérios de pesquisa para ver as linhas serem filtradas instantaneamente. Por exemplo, você pode procurar um ID de subordinado na coluna Subordinado.
Observação:
Também pode clicar em qualquer nome de coluna uma vez para classificar as linhas em ordem decrescente. Clique novamente para reverter a ordem. Para obter mais informações sobre filtragem, consulte Filtrando e classificando colunas de tabelas.
Filtrando e classificando colunas de tabelas
Você pode filtrar cada coluna selecionando seu ícone de filtro e selecionando ou digitando seus critérios de filtro. Para limpar um filtro, clique no botão Limpar Filtros acima da tabela de subordinados.
Você também pode classificar uma coluna selecionando o nome dela. Para personalizar quais colunas são exibidas na tabela, clique no botão Mostrar colunas 
no canto abaixo da tabela de subordinados.
Se você filtrar com base no destino Todos os Subordinados, esse filtro será persistente em todos os seus destinos.
As configurações de filtros, a classificação de colunas e a visibilidade das coluna são persistentes para um determinado usuário, independentemente do dispositivo usado para fazer login. Isso significa que, quando um usuário específico faz login, ele verá as mesmas configurações de filtragem, classificação e visibilidade da próxima vez em que fizer login, até que os filtros sejam limpos ou as configurações de classificação e visibilidade sejam alteradas.
Você também pode classificar uma coluna selecionando o nome dela.
Executando um trabalho assistemático
No espaço de trabalho Subordinados, você pode executar um comando ou trabalho assistemático em:
- Um único subordinado
- Uma lista de subordinados
- Um mestre Salt ou todos os mestres Salt (usando salt-run)
- Um destino
Destinos são dinâmicos, e novos subordinados são adicionados automaticamente a qualquer definição de destino correspondente. Certifique-se de rever os subordinados incluídos em um destino antes de executar um trabalho.
Consulte Fluxo de trabalho de trabalhos do SaltStack Config para obter uma visão geral de como usar o espaço de trabalho Subordinados junto com os outros espaços de trabalho no SaltStack Config para criar e usar trabalhos para gerenciamento de configuração.
Para executar um trabalho assistemático:
- No espaço de trabalho Subordinados, selecione com base em qual subordinado, destino ou lista de subordinados você deseja executar o trabalho:
- Para selecionar um único subordinado ou uma lista de subordinados, marque a caixa ao lado dos subordinados na tabela.
- Para selecionar um destino, clique no nome do destino no painel lateral Destinos. O nome do destino atualmente selecionado é exibido acima da lista de subordinados.
- Clique em Executar trabalho para executar um trabalho.
- Na caixa de diálogo de confirmação, selecione o trabalho que você deseja executar e confirme se o destino ou os subordinados corretos estão selecionados.
- Selecione opções adicionais conforme necessário e clique em Executar agora.
Para obter mais informações sobre trabalhos e as diferentes opções disponíveis ao executar um trabalho, consulte Trabalhos.
Você também pode executar um trabalho em um único subordinado, selecionando seu ID de Subordinado e visualizando a página de detalhes do subordinado.
Executando um comando
No espaço de trabalho Subordinados, você pode executar um comando ou trabalho assistemático em:
- Um único subordinado
- Uma lista de subordinados
- Um mestre Salt ou todos os mestres Salt (usando salt-run)
- Um destino
Destinos são dinâmicos, e novos subordinados são adicionados automaticamente a qualquer definição de destino correspondente. Certifique-se de rever os subordinados incluídos em um destino antes de executar um trabalho.
Consulte Fluxo de trabalho de trabalhos do SaltStack Config para obter uma visão geral de como usar o espaço de trabalho Subordinados junto com os outros espaços de trabalho no SaltStack Config para criar e usar trabalhos para gerenciamento de configuração.
Para executar um comando com base em um ou mais subordinados:
- No espaço de trabalho Subordinados, selecione com base em qual subordinado, destino ou lista de subordinados você deseja executar o trabalho:
- Para selecionar um único subordinado ou uma lista de subordinados, marque a caixa ao lado dos subordinados na tabela.
- Para selecionar um destino, clique no nome do destino no painel lateral Destinos. O nome do destino atualmente selecionado é exibido acima da lista de subordinados.
- Clique em Executar Comando.
- Na caixa de diálogo Executar Comando, confirme se o comando e o destino corretos estão selecionados e escolha uma função.
Observação:
Se você selecionar o comando
salt-run, poderá optar por executar o comando em todos os mestres Salt ou em um mestre Salt específico. Isto é conhecido como um executor Salt. Consulte Executores Salt para obter mais informações.Inclua quaisquer argumentos conforme necessário. Para obter mais informações sobre comandos e funções Salt, consulte Trabalhos.
- Clique em Executar Comando.
O comando é executado como um trabalho. Você pode acompanhar seu progresso e resultados de maneira semelhante a outros trabalhos no SaltStack Config. Consulte Retornos de trabalhos.
Criando um novo destino
Cada destino no SaltStack Config inclui um nome, um mestre Salt e critérios de destino. Para definir um novo destino, incluindo um ou mais subordinados:
- No espaço de trabalho Subordinados, clique em Todos os Subordinados no painel lateral Destinos.
- Clique no botão Criar destino.
- Na caixa de diálogo Criar destino, no campo Nome, insira um nome descritivo para o novo destino.
- 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 Configurações de destinos para obter mais informações.
- Clique no menu Grão e selecione o tipo de destino que você deseja usar. É possível definir subordinados como destino usando grãos, globs, listas ou compostos. 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.
- 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 Composto 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.
- Quando terminar, clique em Salvar.
Definindo um destino de lista simples
Para criar um novo destino usando uma lista simples:
- No espaço de trabalho Subordinados, clique em Todos os Subordinados no painel lateral Destinos.
- 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. Consulte Filtrando e classificando colunas de tabelas.
A lista selecionada é incluída como critério.
- Insira um nome de destino e defina quaisquer configurações de destino adicionais. Consulte Configurações de destinos.
- Quando terminar, clique em Salvar.
Atribuindo um pilar a um destino
Para atribuir dados de pilares a um destino específico de subordinados:
- No espaço de trabalho Subordinados, selecione um destino no painel lateral Destinos.
- Clique em Mais ações.
- No menu, clique em Anexar Pilar.
- 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.
- 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. Consulte Pilares.
Presença de subordinados
A coluna Presença indica se o SaltStack Config recebeu dados de trabalho do subordinado recentemente, dentro de um intervalo definido chamado de raas_presence_expiration. Por padrão, esse intervalo está definido como 3.600 segundos. A coluna Presença pode fornecer um indicador de integridade da máquina usando o beacon Presença instalado em subordinados.
Se o beacon Presença estiver instalado, os subordinados enviarão payloads de status periódicas a seus mestres Salt, que em seguida são recuperadas pelo SaltStack Config, influenciando o status exibido na coluna Presença.
Beacons são usados para monitorar processos não Salt. Quando ocorrem atividades monitoradas, é enviado um evento que pode ser configurado para acionar um reator. Para obter mais informações sobre beacons, consulte a Referência de beacons Salt.
beacons.list no respectivo destino de um subordinado. Consulte
Trabalhos para obter mais informações.
O SaltStack Config fornece os seguintes status de Presença.
| Status | Descrição |
|---|---|
| Desconhecido | O SaltStack Config nunca viu uma resposta do subordinado. Este é o status padrão para subordinados recém-conectados. Assim que os subordinados receberem um comando, o status será atualizado para Presente. |
| Presente | O SaltStack Config viu respostas do subordinado no último intervalo de raas_presence_expiration, definido como 3.600 segundos por padrão. |
| Desconectado | O SaltStack Config viu uma resposta do subordinado, mas não dentro do último intervalo de raas_presence_expiration. |
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.
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árias máquinas 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 criar um destino que inclua o subconjunto inteiro de subordinados, selecionando apenas o mestre Salt.
Para ativar a definição de destinos por mestre Salt, clique nesse 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 destino
Use critérios de destino para especificar um grupo de subordinados, fazendo referência às seguintes descrições de campos.
Destinos são dinâmicos, e novos subordinados são adicionados automaticamente a qualquer definição de destino correspondente. Salvar seu destino como uma lista impede que novos subordinados que correspondam à configuração de destino dinâmica sejam adicionados automaticamente a um destino.
| Tipo de destino | Descrição |
|---|---|
| Grão | Corresponde um valor específico de grão, por exemplo, Para obter mais informações sobre grãos, consulte Referência de grãos Salt.
Observação: Ao criar destinos compostos usando grãos, o RaaS não retornará subordinados se o nome do grão 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. |
| Lista | Especifique uma lista de subordinados a serem incluídos no destino. Por exemplo,
Observação: 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.
|
| Composto | Combine várias interfaces de destino, separadas pelas conjunções “e”, “ou” e “não”. Para tirar proveito de destinos compostos no SaltStack Config, primeiro revise destinos compostos na Referência para definição de destinos no Salt.
Observação: Se você selecionar Composto como critério, deverá seguir a sintaxe de destino composto do Salt e incluir quaisquer critérios secundários na definição de destino composto. O
SaltStack Config não permite incluir quaisquer outros tipos de critérios além de um critério Composto.
|
