Gerencie a configuração Semaphore como código

Defina projetos, repositórios e modelos de tarefa compatíveis como código. Revise um plano Terraform antes de mudar a plataforma de automação.

Instale gratuitamenteDocumentação do provedor
main.tf
resource "semaphoreui_project" "production_ops" {  name = "Production operations"  alert = true  max_parallel_tasks = 10}

Ainda configura o Semaphore manualmente?

Repetir configurações entre projetos consome tempo. Mudanças manuais são fáceis de perder de vista.

Use o provedor Terraform para definir recursos Semaphore compatíveis no Git e revisar antes de aplicar.

Crie seu primeiro projeto Semaphore com Terraform

Configuração Terraform gerencia projetos, repositórios e modelos Semaphore pela API
  1. 01

    Conecte o provedor ao Semaphore

    Defina o endereço Semaphore e autentique com token de API.

  2. 02

    Defina recursos no Git

    Declare projetos, repositórios e modelos de tarefa. Revise alterações no mesmo pull request da configuração de infraestrutura.

  3. 03

    Revise o plano e aplique

    Inspecione as alterações propostas antes de aplicá-las. Mantenha a configuração no Git para a próxima atualização.

Obtenha o provedor Terraform

Gerencie a plataforma da qual seus trabalhos dependem

Gerencie os trabalhos que a equipe executa

Mantenha configurações reutilizáveis de execução em recursos compatíveis do provedor.

Modelos de tarefas

Conecte a configuração à API

O provedor configura o Semaphore pela mesma API da plataforma.

API e webhooks

Onde termina o provedor e começa o Semaphore

Configure a plataforma que executa seus trabalhos

O README do provedor lista projetos, ambientes, inventários, chaves, repositórios, agendamentos, modelos, usuários e visões. A cobertura depende da versão. Use a documentação do registro para confirmar campos e ciclo de vida, em vez de presumir representação de toda configuração da UI.

Revise alterações da plataforma antes de aplicar

Um plano ajuda a equipe a ver as alterações propostas nos recursos gerenciados. Alterar um modelo pode modificar uma execução operacional futura. Por isso, revise essas diferenças com o mesmo cuidado dedicado ao código executável. O estado do Terraform e as credenciais dos provedores também exigem controles de acesso adequados e uma estratégia de backend.

Entenda o modelo atual de manutenção

O repositório do provedor atualmente descreve manutenção de melhor esforço com auxílio de IA e informa não ser mantido ativamente. Isso importa para adoção. Teste os recursos usados, fixe versões e leia issues abertas antes de torná-lo uma dependência crítica de provisionamento.

Documentação e recursos relacionados

FAQ

O que o provedor Terraform do Semaphore gerencia?

O provedor gerencia recursos Semaphore compatíveis pela API, como projetos, repositórios, modelos e outras famílias documentadas. Ele configura a plataforma. Isso difere de usar o Semaphore para executar Terraform que gerencia sua infraestrutura de nuvem. Confira recursos e argumentos da versão fixada: uma opção disponível na UI não prova suporte pelo provedor.

Preciso executar Terraform dentro do Semaphore para usar o provedor?

Não. O provedor pode executar onde você usa Terraform, desde que o ambiente acesse a API Semaphore e autentique com as permissões necessárias. Pode ser uma estação de trabalho ou pipeline existente. Deixe explícitos o ambiente de execução, as credenciais de API e o backend de estado do provedor. Se depois executá-lo pelo próprio Semaphore, avalie essa dependência com cuidado para manter recuperáveis a configuração da plataforma e a capacidade de executá-la.

Posso usar o provedor Terraform do Semaphore com OpenTofu?

O provedor usa o protocolo de provedores Terraform. Um teste local fixou semaphoreui/semaphore 0.3.9 no OpenTofu contra Semaphore 2.19.12 isolado. O teste leu um projeto existente, criou um descartável e não encontrou desvio no plan seguinte. Não testou a CLI Terraform nem todos os recursos. Fixe suas versões e verifique os recursos e operações de ciclo de vida necessários antes de adotar.

Posso importar para o Terraform recursos já criados pela interface?

Confira o suporte à importação e o identificador exigido para cada recurso na documentação da versão fixada do provedor. Não presuma que todos os recursos têm o mesmo comportamento de importação. Defina como a configuração existente será representada e qual sistema será responsável pelas alterações seguintes antes de aplicar um plano. Comece por um recurso fora de produção, inspecione o estado resultante e as alterações propostas e evite substituir acidentalmente uma configuração compartilhada em funcionamento.

Podemos manter a configuração do Semaphore no Git?

Sim. Mantenha configuração Terraform dos recursos Semaphore compatíveis em repositório versionado e revise por pull request. O provedor aplica pela API Semaphore. Separe credenciais API do código e use backend de estado adequado à configuração gerenciada.

O provedor pode gerenciar modelos de tarefa?

Modelos de tarefa são uma das famílias documentadas de recursos do provedor. Use a referência do registro para os argumentos exatos da versão fixada. Uma mudança no modelo pode afetar execuções futuras; revise o plano e confirme a configuração resultante no Semaphore antes de a equipe usar o trabalho atualizado.

O provedor é o mesmo que executar Terraform no Semaphore?

Têm objetivos distintos. O provedor gerencia a configuração Semaphore pela API. Um modelo Terraform executa sua configuração de infraestrutura no Semaphore. Use independentemente: configure a plataforma a partir do ambiente Terraform existente e use os modelos para executar os trabalhos já mantidos pela equipe.

Onde manter token de API do provedor e estado Terraform?

Forneça o token de API pela configuração compatível do provedor sem enviá-lo ao Git. Escolha backend de estado Terraform com controles de acesso e backup adequados à equipe. O ambiente que executa o provedor precisa de acesso de rede ao Semaphore e identidade autorizada a gerenciar os recursos declarados.