Playbooks Customizados

Requisitos

Linux Control Center = 2.10.X ou superior

Objetivo

Este manual tem como objetivo apresentar todos os recursos que o módulo Playbooks do LCC oferece.

Overview

No Linux Control Center (LCC), o módulo Playbooks desempenha um papel importante na administração, oferecendo aos usuários a capacidade de executar playbooks personalizados em hosts gerenciados pelo LCC.

A execução de um playbook pelo LCC oferece uma visão completa do processo, permitindo monitorar o andamento em tempo real e gerar relatórios detalhados. Além disso, a execução pode ser realizado pelo Workflow, que permite tomar decisões dinâmicas com base nos resultados de cada etapa.

Upload e Configuração de Playbooks

1. Para iniciar, acesse o LCC e clique em Playbooks no menu lateral esquerdo.

   
2. Clique em Create

   
3. Insira um nome para identificar o playbook no campo Name.

4. Clique em Upload File e escolha o playbook desejado em seu computador.

   
5. Veja que o nome do playbook será exibido no campo Current File

6. Clique em Save e logo em seguida o playbook estará salvo no banco de dados do LCC.

   
7. Clique no Playbook que foi criado e sera possível ver as seguintes telas:

Informações Gerais

1. Tela que exibe a data e hora em que o playbook foi criado, data e hora da ultima alteração e também é possível alterar as informações do campo Name e Descrição. Também é possível baixar o arquivo clicando em Download,deletar clicando em Delete e realizar o upload de um novo arquivo clicano em Change File

   

Variáveis Dinâmicas no Playbook

Semelhante aos Scripts Customizáveis os playbooks também possuem a capacidade de inserir variáveis. Isso permite a execução do mesmo playbook em momentos diferentes com valores distintos, oferecendo adaptabilidade conforme necessário. O formato da variável é ${:::Nome da variável:::}, sendo o Nome da variável o identificador daquela variável.

Após criar o playbook com a variável nesse formato e realizar o upload do arquivo para a console, será possível alterar seu valor diretamente pela interface web do LCC sempre que necessário. O valor atualizado será salvo automaticamente no arquivo do playbook salvo no banco de dados.

1. Veja um exemplo de implementação deste formato de variável

   var_name: ${:::var_name:::}

   

É importante notar que caso sejam escritas variáveis com o mesmo identificador/nome o LCC irá substituir o valor da ultima variável inserida pelo usuário em todas as outras. Logo é recomendado utilizar nomes diferentes caso os valores desejados de execução sejam distintos.

Conteúdo do Playbook

1. A tela Content exibe todo o conteúdo do playbook. Na imagem abaixo está a variável citada no tópico anterior.

   

Credenciais de execução

1. Na tela Credentials O LCC permite que o Playbook seja executado com uma credencial diferente da padrão lcc.local. É possível utilizar Credenciais Linux que estão cadastradas na console do LCC, Credenciais do cofre de senha Password Safe da BeyondTrust por meio de integração e por meio da funcionalidade Hook Bridge Params do LCC.

   

OS Release

1. Esta funcionalidade permite que o Playbook seja executado em somente em uma determinada Distribuição Linux.

2. Clique em Create

   
3. Clique em Release, escolha a Distribuição Linux que o playbook será executado e clique em Save

   

Execução de Playbooks

1. Para executar o playbook, basta acessar a tela Playbooks e clicar em Actions do playbook desejado actions_playbook.png

   
2. Clique em Run

   
3. Escolha em qual Host ou Grupo Host o playbook será executado

4. Clique em Yes e o playbook será executado logo em seguida.