Vai al contenuto
Documentazione
Utilizzo del registro

Utilizzo del registro

Visualizza come Markdown

Il provider Status200 è pubblicato nel Terraform Registry e nell'OpenTofu Registry. terraform init e tofu init lo scaricano da lì: non c'è nulla da installare a mano. Questa pagina spiega cosa viene pubblicato, come sono numerate le versioni e come passare a una versione più recente.

Cosa viene pubblicatoIl provider per ogni piattaforma, il suo riferimento e le sue versioni.Come sono numerate le versioniLa versione di un provider è la release di Status200 che lo ha pubblicato.Il file di lockLa versione e i checksum che ogni macchina installa.Passare a una versione più recenteLeggere cosa è cambiato, scaricarla e pianificare.

Cosa viene pubblicato

Ogni release di Status200 genera il provider dall'API stessa di Status200. Quando il provider è cambiato, la release lo pubblica, con la versione della release, dopo che ha superato i suoi test end-to-end con Terraform e con OpenTofu:

flowchart TB R["Una release di Status200"] --> G["Il provider viene generato<br/>dall'API di Status200"] G --> C{"Il provider<br/>è cambiato?"} C -->|"sì"| P["Testato con Terraform<br/>e OpenTofu, poi<br/>pubblicato con la<br/>versione della release"] C -->|"no"| N["Nessuna versione<br/>del provider per<br/>questa release"] P --> I["terraform init<br/>e tofu init<br/>lo scaricano"]

Da una release di Status200 al tuo terraform init

CosaDove
Il provider, per Linux, macOS, Windows, FreeBSD, OpenBSD e SolarisScaricato da terraform init e tofu init, con checksum che Status200 firma
Il riferimento di ogni risorsa e sorgente dati, con ognuno dei suoi attributiLa documentazione del registro, raggruppata per prodotto: monitor, pagine di stato, incidenti, reperibilità e gli altri
Una guida all'uso del provider con OpenTofuLe guide del registro
Ogni versione, la più recente per primaL'elenco delle versioni del registro

Il riferimento dice cos'è ogni attributo. Questa documentazione mostra come usarli insieme: inizia dalla Panoramica di Terraform.

Come sono numerate le versioni

La versione di un provider è la versione della release di Status200 che lo ha pubblicato: il provider 14.0.20 è arrivato con Status200 14.0.20. Una release il cui provider non è cambiato non ne pubblica nessuno, quindi le versioni hanno dei buchi, e un vincolo che nomina una sola versione esatta può nominare una versione che non esiste. Scrivi invece un intervallo:

UsiVincoloTerraform installa
Status200 Cloud~> 14.0Il provider 14.x più recente
Un'istanza Status200 self-hostedUn intervallo che termina alla versione della tua istanza Status200, come >= 14.0, <= 14.0.40Il provider più recente che non sia più recente della tua istanza Status200

Su un'istanza Status200 self-hosted, un provider più recente della tua istanza può inviare impostazioni che la tua istanza non ha ancora: Configurazione self-hosted mostra come scriverne l'intervallo.

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

L'indirizzo sorgente non nomina nessun registro: Terraform lo legge nel Terraform Registry, e OpenTofu nell'OpenTofu Registry, che pubblicano le stesse versioni.

Il file di lock

terraform init registra la versione che ha scelto, e i checksum dei suoi download, in .terraform.lock.hcl. Esegui il commit di questo file: ogni macchina ed esecuzione di CI installa allora esattamente quella versione, finché non ne scegli un'altra. I checksum coprono ogni piattaforma che il registro pubblica, quindi un solo file di lock serve allo stesso modo macchine Linux, macOS e Windows.

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

Il file di lock nomina il registro. OpenTofu scrive registry.opentofu.org/status200/status200 dove Terraform scrive registry.terraform.io/status200/status200, quindi cambiare motore modifica il file di lock: init sostituisce la voce, e ti chiede di eseguire il commit della modifica.

Passare a una versione più recente

  1. Leggere cosa è cambiato

    Le release di Status200 dicono cosa ha cambiato ogni release, provider compreso. Le release del provider rimandano alle modifiche rispetto alla precedente.

  2. Scaricarla

    Bash 
    terraform init -upgrade

    init -upgrade prende la versione più recente che il tuo vincolo permette, la stampa e aggiorna .terraform.lock.hcl. Il vincolo ~> 14.0 prende ogni release 14.x; una nuova versione principale richiede un nuovo vincolo.

  3. Pianificare prima di applicare

    Esegui terraform plan, e applica solo quando è vuoto o mostra le modifiche che ti aspetti. Esegui il commit del file di lock aggiornato.

Su un'istanza Status200 self-hosted, aggiorna prima Status200, poi sposta in avanti la fine dell'intervallo del provider.

Dove si trova il codice

Il provider è generato dall'API di Status200 nel repository principale di Status200, e ogni versione viene compilata dalla release che l'ha pubblicata. Il suo repository, OneUptime/terraform-provider-status200, contiene ciò che il generatore ha scritto, quindi le modifiche si fanno nel repository principale: segnala i problemi, compresi quelli della documentazione, su git.wilix.dev/status200/status200/issues.

Prossimi passi

Configurazione self-hostedL'intervallo di versioni per la tua istanza Status200, e un mirror per le macchine offline.OpenTofuLo stesso provider e la stessa configurazione, con tofu.Guida completaAutenticazione, struttura del progetto, sorgenti dati, stato e aggiornamenti.Risoluzione dei problemiGli errori comuni e come correggerli.