Uso do registro

O provider do Status200 é publicado no Terraform Registry e no OpenTofu Registry. terraform init e tofu init o baixam de lá: não há nada para instalar à mão. Esta página explica o que é publicado, como as versões são numeradas e como passar para uma versão mais nova.

O que é publicado#

Toda versão do Status200 gera o provider a partir da própria API do Status200. Quando o provider mudou, a versão o publica, com o número dessa versão, depois que ele passa nos testes de ponta a ponta com o Terraform e com o OpenTofu:

A referência diz o que é cada atributo. Esta documentação mostra como usá-los juntos: comece pela Visão geral do Terraform.

Como as versões são numeradas#

A versão de um provider é a da versão do Status200 que o publicou: o provider 14.0.20 veio com o Status200 14.0.20. Uma versão cujo provider não mudou não publica nenhum, então as versões têm lacunas, e uma restrição que nomeia uma única versão exata pode nomear uma versão que não existe. Escreva um intervalo em vez disso:

Em um Status200 auto-hospedado, um provider mais novo que o seu Status200 pode enviar opções que o seu Status200 ainda não tem: a Configuração auto-hospedada mostra como escrever o intervalo dele.

terraform {
  required_providers {
    oneuptime = {
      source  = "oneuptime/status200"
      version = "~> 14.0"
    }
  }
}

O endereço de origem não nomeia nenhum registro: o Terraform o lê no Terraform Registry, e o OpenTofu no OpenTofu Registry, que publicam as mesmas versões.

O arquivo de lock#

terraform init registra a versão que escolheu, e os checksums dos downloads dela, em .terraform.lock.hcl. Faça commit desse arquivo: toda máquina e toda execução de CI passa a instalar exatamente essa versão, até você escolher outra. Os checksums cobrem todas as plataformas que o registro publica, então um único arquivo de lock serve igualmente a máquinas Linux, macOS e Windows.

provider "registry.terraform.io/status200/status200" {
  version     = "14.0.20"
  constraints = "~> 14.0"
  hashes = [
    "h1:...",
    "zh:...",
  ]
}

O arquivo de lock nomeia o registro. O OpenTofu escreve registry.opentofu.org/status200/status200 onde o Terraform escreve registry.terraform.io/status200/status200, então trocar de ferramenta altera o arquivo de lock: o init substitui a entrada, e pede que você faça commit da alteração.

Passar para uma versão mais nova#

1. Ler o que mudou#

   As versões do Status200 dizem o que cada versão mudou, inclusive no provider. As versões do provider apontam para as alterações desde a anterior.

2. Baixá-la#

   Bash

   terraform init -upgrade

   init -upgrade pega a versão mais nova que a sua restrição permite, a mostra e atualiza .terraform.lock.hcl. A restrição ~> 14.0 pega toda versão 14.x; uma nova versão principal precisa de uma nova restrição.

3. Planejar antes de aplicar#

   Execute terraform plan, e aplique só quando ele estiver vazio ou mostrar as alterações que você espera. Faça commit do arquivo de lock atualizado.

Em um Status200 auto-hospedado, atualize primeiro o Status200, e depois avance o fim do intervalo do provider.

Onde fica o código#

O provider é gerado a partir da API do Status200 no repositório principal do Status200, e cada versão é construída a partir da versão do Status200 que a publicou. O repositório próprio dele, OneUptime/terraform-provider-status200, contém o que o gerador escreveu, então as alterações são feitas no repositório principal: informe problemas, inclusive os da documentação, em git.wilix.dev/status200/status200/issues.

Próximos passos#