# Agendamentos

## Requisitos

Linux Control Center = 2.12.X ou superior

## Overview

* O recurso de Schedule na plataforma Linux Control Center oferece uma capacidade robusta de automação temporal. Este recurso permite agendar operações precisas para Hosts individuais, Grupos de Hosts ou execução de fluxo de trabalhos (Workflow).
* As opções de agendamento abrangem todas as *Actions* do LCC para eventos únicos ou recorrentes, proporcionando flexibilidade no formato de agendamento.

## Objetivo

Este documento tem como objetivo demonstrar o passo a passo para criar um agendamento no Linux Control Center.

## Criar um Agendamento

1. Acesse a tela **Schedule** no menu lateral esquerdo.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-cd8c4094e9e6334102d4aca4b7b0b48b49a764f8%2Ftela_schedule_dashboard.png?alt=media)
2. Clique em **Create**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-08996b67fef5fd0cacbe924fd108733288778e16%2Fbotao_create.png?alt=media)
3. Preencha o campo **Name** para identificar o agendemento.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-ba437ca07e080151e837a6188fee09aa2aee0f2c%2Fcampo_name.png?alt=media)

## Seleção de Ação

1. A primeira etapa é selecionar qual **Action** será executada no agendamento.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Apenas uma ação pode ser executada por agendamento, assim como somente uma das três opções dentre <em>Host/Host Group, Discover, Workflow, Reports</em> podem ser selecionadas por vez.</p><p>Caso seja necessário executar mais de uma ação em um único agendamento deve-se criar um fluxo de <em>Workflow</em> e agendar a sua execução para o horário desejado.</p></div>

### Hosts / Host Groups

1. Marque a primeira opção para executar uma *Action* do LCC em um Host ou em um Grupo de Host.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-e4b40223771f8ca5c7f5c0a3921b12a0b73bee10%2Faction_hosts_group.png?alt=media)
2. Pelo menos 1 **Host** ou um **Grupo de Host** deve ser selecionado.
3. Também é possível executar em Host individual ou em Grupo de Host simultaneamente.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-f54fb905d3794b0b23e9e9be707b8035d8f0f419%2Fgrupo_hosts_selecionados.png?alt=media)
4. Escolha a **Action** em que deseja executar no agendamento.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-d23acf30537d3749100dfdc5d2fc8d24f17cdbc8%2Fcampo_actions_hosts.png?alt=media)

### Discover

1. Marque a opção **Discover** caso deseja agendar a execução de um **Discover** pré configurado. Este agendamento permite executar apenas 1 Discover.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-ea9dcf7a1838e4119ffe9698db43ed732c328b10%2Fdiscover_run.png?alt=media)

### Workflow

1. Clique em **Workflow** para agendar a execução de um **Workflow** pré configurado.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-8f33c11c1d144d928072a381bc919b8c2645226b%2Fworkflow_run.png?alt=media)

### Reports

1. Clique em **Reports** para escolher qual Report pré configurado será criado no agendamento.

   ![](https://gitlab.com/7dev-doc/linux-control-center/-/blob/main/pt-br/images/schedule/create_schedule)

## Tipo de Agendamento

* Esta etapa define quantas vezes e em que momento o agendamento será executado.

### Uma vez

* Com este tipo de agendamento, a *Ação* será executada apenas uma única vez e o agendamento permanecerá salvo na Console do LCC.

1. Marque a opção **One Time** para executar apenas 1 única vez.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-c79428d4ab39694e61f830cf0deb39c1c7e23c0a%2Fcaixa_one_type.png?alt=media)
2. Insira a **Hora** em que deseja executar no campo **Hour**. (Formato 24 Horas)
3. Insira a **Minuto** em que deseja executar no campo **Minute**. (0 até 59)

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-7534cdc7adcd7d2654c44f340f3a0e92828f739d%2Fhora_minuto_one_type.png?alt=media)
4. Insira o dia do **Mês** em que deseja executar a ação no campo **Date**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-0893b972ef119ce610e9607b0e08928c4852c795%2Fselect_date_one_time.png?alt=media)

### Repetidamente

* O tipo de agendamento *Repetidamente* permite a execução conforme as 3 opções abaixo;

#### A Cada Minuto

1. Marque a caixa **Minute** e insira de quantos em quantos minutos a *Ação* será executada. Desta forma, a ação será executada a cada X minutos definido. (1 ate 59)

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-a266c1a1a53401ec357ac64aba085f0f3e8f357f%2Fevery_minute.png?alt=media)

#### Diariamente

* Esse tipo de agendamento executa a *Ação* apenas uma vez por dia, no horário configurado.

1. Insira a *Hora* do dia em que deseja executar a *Ação* no campo **Hour**. (Formato 24 Horas)
2. Insira o *Minuto* da hora em que deseja executar a *Ação* no campo **Minutes**. (0 até 59)

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-e91523732eb099d4eec82bf8488423c18392d9db%2Frepetidamente_daily.png?alt=media)

#### Avançado

{% hint style="info" %}

* Se você deseja que a *Ação* seja executada diariamente, basta deixar o campo **Day of Week** em branco(\*)

* Se você deseja que a *Ação* seja executada mensalmente, basta deixar o campo **Month** em branco(\*)
  {% endhint %}

* Este tipo de agendamento permite que a ação seja executada a cada *Dia da semana*, *Dia do Mês* ou a cada *Mês*.

  ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-b4f41bc1da4b47d9f6edd117a54f00487255eb46%2Fbotao_advanced.png?alt=media)

1. Selecione o dia da semana em que a *Ação* sempre será executada no campo **Day of Week**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-2d1b214e5168fb321ad49cb0bfe979dca65d8dbe%2Fdia_semana.png?alt=media)
2. Selecione o dia do mês em que a *Ação* sempre será executada no campo **Day of Month**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-00a4347b22984bbe91b94c1a1ec66f87498264c7%2Fdia_mes.png?alt=media)
3. Selecione o mês em que a *Ação* sempre será executada no campo **Month**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-1598dfd95cc12a3c4547d9c38ac155794dd5120c%2Fmes_ano.png?alt=media)

## Salvar e Habilitar ou Desabilitar Agendamento

1. Clique em **Save** para criar o agendamento.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-00dbff9581cc2f77281f8ebe89465c8b20178770%2Fbotao_save.png?alt=media)
2. A tela dos agendamentos criados exibe algumas informações;

   **Enabled/Disable**: Indica se o agendamento está habilitado ou desabilitado.\
   **Repeat**: Indica que o agendamento irá ocorrer periodicamente de acordo com a data preenchida.\
   **Last Run at**: Data da ultima execução do agendamento.\
   **Created at**: Data de criação do agendamento.\
   **Updated at**: Data da última alteração do agendamento.<br>
3. Clique no agendamento criado.

   ![](https://gitlab.com/7dev-doc/linux-control-center/-/blob/main/pt-br/images/schedule/create_schedule)
4. O Campo **Habilitar Agenda** possibilita Habilitar e/ou Desabilitar o Agendamento. Ao Habilitar, o agendamento será executado autmaticamente conforme a configuração.

   ![](https://gitlab.com/7dev-doc/linux-control-center/-/blob/main/pt-br/images/schedule/create_schedule)
5. Também é possível *Deletar* um agendamento permanentemente ao clicar no botão **Delete**.

   ![](https://gitlab.com/7dev-doc/linux-control-center/-/blob/main/pt-br/images/schedule/create_schedule)


---

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