# 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.

   ![](/files/7v0lPKzM8rnS2M0Rb2P8)
2. Clique em **Create**

   ![](/files/N2D5CXJrIhdWiD4MzYRQ)
3. Insira um nome para identificar o playbook no campo **Name**.
4. Clique em **Upload File** e escolha o playbook desejado em seu computador.

   ![](/files/bb8X2N6NDM7KCxkn0JpZ)
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.

   ![](/files/MELozzoUOy9m6sxuPV8A)
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 ao clicar em **Download**, deletar ao clicar em **Delete** e realizar o upload de um novo arquivo ao clicar em **Change File**

   ![](/files/1cFGPlCcMTo6cgabWw1m)

### 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:::}***

   ![](/files/hrdoMNp754EvV39oRt1o)

{% hint style="warning" %}
É 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.
{% endhint %}

### 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.

   ![](/files/vqcsAn1bMdorHI0JSTcB)

### 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.

   ![](/files/NvmaQtWEkr4cjR2mVEEy)

### OS Release

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

   ![](/files/Vox9Jo7jgI8cK8vImz5J)
3. Clique em **Release**, escolha a Distribuição Linux que o playbook será executado e clique em **Save**.

   ![](/files/gXRtImwAdRgEnrbcmqQC)

## Execução de Playbooks

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

   ![](/files/OMbaVW2ZvBaqYmw0kDzB)
2. Clique em **Run**

   ![](/files/6KSe2TeJTWyVCrDdzpQv)
3. Escolha em qual **Host** ou **Grupo Host** o playbook será executado
4. Clique em **Yes** e o playbook será executado logo em seguida.

   ![](/files/q6ePiXkk7hV8Gp5SZ4T2)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.linuxcontrolcenter.com.br/customizable-playbooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.