Utilisation du registre

Le fournisseur Status200 est publié dans le Terraform Registry et dans l'OpenTofu Registry. terraform init et tofu init le téléchargent depuis là : il n'y a rien à installer à la main. Cette page explique ce qui est publié, comment les versions sont numérotées et comment passer à une version plus récente.

Ce qui est publié#

Chaque version de Status200 génère le fournisseur à partir de la propre API de Status200. Quand le fournisseur a changé, la version le publie, sous le numéro de cette version, une fois qu'il a réussi ses tests de bout en bout avec Terraform et avec OpenTofu :

La référence indique ce qu'est chaque attribut. Cette documentation montre comment les utiliser ensemble : commencez par la Vue d'ensemble de Terraform.

Comment les versions sont numérotées#

La version d'un fournisseur est celle de la version de Status200 qui l'a publié : le fournisseur 14.0.20 est arrivé avec Status200 14.0.20. Une version dont le fournisseur n'a pas changé n'en publie aucun, donc les versions ont des trous, et une contrainte qui nomme une seule version exacte peut nommer une version qui n'existe pas. Écrivez plutôt une plage :

Sur un Status200 auto-hébergé, un fournisseur plus récent que votre Status200 peut envoyer des paramètres que votre Status200 n'a pas encore : Configuration auto-hébergée montre comment écrire sa plage.

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

L'adresse source ne nomme aucun registre : Terraform la lit dans le Terraform Registry, et OpenTofu dans l'OpenTofu Registry, qui publient les mêmes versions.

Le fichier de verrouillage#

terraform init enregistre la version qu'il a choisie, et les sommes de contrôle de ses téléchargements, dans .terraform.lock.hcl. Commitez ce fichier : chaque machine et chaque exécution de CI installent alors exactement cette version, jusqu'à ce que vous en choisissiez une autre. Les sommes de contrôle couvrent chaque plateforme que publie le registre, si bien qu'un fichier de verrouillage sert aussi bien les machines sous Linux, macOS et Windows.

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

Le fichier de verrouillage nomme le registre. OpenTofu écrit registry.opentofu.org/status200/status200 là où Terraform écrit registry.terraform.io/status200/status200, donc changer de moteur modifie le fichier de verrouillage : init remplace l'entrée, et vous demande de commiter le changement.

Passer à une version plus récente#

1. Lire ce qui a changé#

   Les versions de Status200 disent ce que chaque version a changé, le fournisseur compris. Les versions du fournisseur renvoient aux changements depuis la précédente.

2. La télécharger#

   Bash

   terraform init -upgrade

   init -upgrade prend la version la plus récente que permet votre contrainte, l'affiche et met à jour .terraform.lock.hcl. La contrainte ~> 14.0 prend chaque version 14.x ; une nouvelle version majeure demande une nouvelle contrainte.

3. Planifier avant d'appliquer#

   Exécutez terraform plan, et n'appliquez que lorsqu'il est vide ou montre les changements que vous attendez. Commitez le fichier de verrouillage mis à jour.

Sur un Status200 auto-hébergé, mettez d'abord à jour Status200, puis montez la fin de la plage du fournisseur.

Où se trouve le code#

Le fournisseur est généré à partir de l'API de Status200 dans le dépôt principal de Status200, et chaque version est construite à partir de la version qui l'a publiée. Son propre dépôt, OneUptime/terraform-provider-status200, contient ce que le générateur a écrit, donc les changements se font dans le dépôt principal : signalez les problèmes, ceux de la documentation compris, sur git.wilix.dev/status200/status200/issues.

Étapes suivantes#