Guia de Administração
Esta seção é destinada a administradores que instalam e operam o Semaphore para outras pessoas. Tudo o que está aqui exige acesso ao próprio servidor: o arquivo de configuração, as variáveis de ambiente, a linha de comando ou a máquina em que o Semaphore é executado. O trabalho feito dentro de um projeto pela interface web é abordado no Guia do Usuário.
O Semaphore é um único binário Go com uma interface web e uma API REST. Ele armazena seus dados em SQLite, MySQL ou PostgreSQL, mantém as credenciais criptografadas e executa tarefas no próprio servidor ou em runners separados. Uma instalação em funcionamento se resume, portanto, a quatro decisões: como instalá-lo, onde fica o banco de dados, como os usuários fazem login e onde as tarefas são executadas.
Configurar
Tudo o que você configura antes de iniciar o servidor ou ao redor dele.
| Página | O que aborda |
|---|---|
| Instalação | Gerenciador de pacotes, Docker, binário, Kubernetes e uma instalação manual. |
| Configuração | O arquivo config.json, as variáveis de ambiente e todas as opções suportadas. |
| Atualização | Migrar para uma versão mais recente e o que verificar primeiro. |
| Proxy reverso | Servir o Semaphore atrás de nginx, Apache ou Caddy, com TLS. |
| Segurança | Hash de senhas, criptografia de segredos, proteção de rede e JWTs de tarefa. |
| Autenticação | Contas locais e duplo fator, LDAP e Active Directory, e início de sessão único com doze fornecedores OpenID Connect. |
| Runners | Executar tarefas em máquinas diferentes do servidor. |
| Alta disponibilidade | Executar vários nós do Semaphore sobre um único banco de dados. |
Operar
Tudo o que você faz em um servidor que já está em execução.
| Página | O que aborda |
|---|---|
| CLI | Gerenciar usuários, projetos, vaults, runners e migrações de banco de dados pelo shell. |
| API | Autenticar-se com um token e controlar o Semaphore programaticamente. |
| Integração com CI/CD | Iniciar tarefas do Semaphore a partir de um pipeline externo. |
| Logs | Logs do servidor, logs de tarefas e como encaminhá-los para outro lugar. |
| Métricas | O endpoint do Prometheus e as métricas que ele expõe. |
| Notificações | Canais de entrega de alertas: e-mail, Telegram, Slack e outros. |
| Licença | Ativar uma assinatura Pro ou Enterprise. |
Por onde começar
Se você está instalando o Semaphore pela primeira vez, leia Instalação e escolha um método, depois Configuração para entender como as opções são informadas. Coloque o servidor atrás de um proxy reverso com TLS antes que qualquer outra pessoa o utilize.
Para ver o que uma assinatura paga acrescenta, consulte Edições.