Guia do Usuário
Esta seção é destinada a quem já tem acesso a um projeto do Semaphore. Tudo o que está aqui acontece na interface web ou pela API do projeto. A instalação do servidor, sua configuração e a conexão de um provedor de identidade são abordadas no Guia de Administração.
O trabalho no Semaphore segue uma única cadeia. Um projeto contém todo o resto. Dentro dele você registra os recursos de que uma execução precisa: um repositório com seus playbooks ou scripts, as chaves usadas para acessá-lo e alcançar seus hosts, um inventário de máquinas de destino e grupos de variáveis com valores e segredos. Um modelo de tarefa combina tudo isso em uma definição do que executar, e cada execução desse modelo é uma tarefa. Agendamentos, workflows e webhooks recebidos iniciam modelos para você.
Configurar um projeto
Nesta ordem, porque cada etapa depende da anterior.
| Página | O que aborda |
|---|---|
| Projetos | Criar um projeto, as seções da barra lateral, backup e restauração. |
| Equipes | Os quatro papéis integrados e os papéis personalizados no Enterprise. |
| Armazenamento de Chaves | Chaves SSH, logins e armazenamentos externos de segredos. |
| Repositórios | Repositórios Git e caminhos locais que contêm sua automação. |
| Inventário | Hosts e configurações de conexão para o Ansible, workspaces para o Terraform. |
| Grupos de Variáveis | Variáveis e segredos reutilizáveis passados para as tarefas. |
Definir e executar o trabalho
| Página | O que aborda |
|---|---|
| Modelos de Tarefa | Todos os campos do formulário de modelo, além dos tipos de modelo. |
| Aplicações | O que cada aplicação executa: Ansible, Terraform, OpenTofu, Terragrunt e scripts. |
| Tarefas | Iniciar uma tarefa, status de tarefas, logs, parada e reexecução. |
| Agendamentos | Executar modelos em uma agenda cron. |
| Workflows | Encadear modelos com aprovações e ramificações. |
| Integrações | Iniciar tarefas a partir de webhooks recebidos. |
| Runners do projeto | Enviar as tarefas de um projeto para os seus próprios runners. |
| Sua conta | Configurações pessoais e tokens de API. |
Por onde começar
Se alguém acabou de adicionar você a um projeto, leia Projetos para se orientar e depois Tarefas para executar uma e ler o seu log. Se você está montando um projeto do zero, siga a tabela acima na ordem.
É totalmente novo no Semaphore? Comece por Primeiros passos.