Gå til indhold
Dokumentation
Registerbrug

Registerbrug

Vis som Markdown

Status200-provideren udgives i Terraform Registry og OpenTofu Registry. terraform init og tofu init henter den derfra: der er intet at installere i hånden. Denne side dækker, hvad der udgives, hvordan versioner nummereres, og hvordan du skifter til en nyere.

Hvad der udgivesProvideren til hver platform, dens reference og dens versioner.Hvordan versioner nummereresEn providers version er den Status200-release, der udgav den.LåsefilenDen version og de checksums, hver maskine installerer.Skift til en nyere versionLæs, hvad der ændrede sig, hent den, og planlæg.

Hvad der udgives

Hver Status200-release genererer provideren ud fra Status200s eget API. Når provideren har ændret sig, udgiver releasen den, under releasens version, når den har bestået sine end-to-end-test under Terraform og under OpenTofu:

flowchart TB R["En Status200-release"] --> G["Provideren genereres<br/>ud fra Status200s API"] G --> C{"Har provideren<br/>ændret sig?"} C -->|"ja"| P["Testet under Terraform<br/>og OpenTofu, derefter<br/>udgivet med<br/>releasens version"] C -->|"nej"| N["Ingen providerversion<br/>for denne release"] P --> I["terraform init<br/>og tofu init<br/>henter den"]

Fra en Status200-release til din terraform init

HvadHvor
Provideren, til Linux, macOS, Windows, FreeBSD, OpenBSD og SolarisHentes af terraform init og tofu init, med checksums, som Status200 signerer
Referencen for hver ressource og datakilde, med hver af dens attributterRegistrets dokumentation, grupperet efter produkt: overvågninger, statussider, hændelser, vagter og de andre
En vejledning i at bruge provideren med OpenTofuRegistrets vejledninger
Hver version, nyeste førstRegistrets versionsliste

Referencen fortæller, hvad hver attribut er. Denne dokumentation viser, hvordan du bruger dem sammen: start fra Terraform – Oversigt.

Hvordan versioner nummereres

En providers version er versionen af den Status200-release, der udgav den: provider 14.0.20 kom med Status200 14.0.20. En release, hvis provider ikke ændrede sig, udgiver ingen, så versionerne har huller, og en begrænsning, der nævner én præcis version, kan nævne en version, der ikke findes. Skriv i stedet et interval:

Du brugerBegrænsningTerraform installerer
Status200 Cloud~> 14.0Den nyeste 14.x-provider
En selv-hostet Status200Et interval, der slutter ved din Status200s version, som >= 14.0, <= 14.0.40Den nyeste provider, der ikke er nyere end din Status200

På en selv-hostet Status200 kan en provider, der er nyere end din Status200, sende indstillinger, som din Status200 endnu ikke har: Selv-hostet opsætning viser, hvordan du skriver dens interval.

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

Kildeadressen nævner intet register: Terraform læser den fra Terraform Registry, og OpenTofu fra OpenTofu Registry, som udgiver de samme versioner.

Låsefilen

terraform init registrerer den version, den valgte, og checksums for dens downloads i .terraform.lock.hcl. Commit den fil: hver maskine og hver CI-kørsel installerer så præcis den version, indtil du vælger en anden. Checksums dækker hver platform, registret udgiver, så én låsefil fungerer lige godt for Linux-, macOS- og Windows-maskiner.

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

Låsefilen nævner registret. OpenTofu skriver registry.opentofu.org/status200/status200, hvor Terraform skriver registry.terraform.io/status200/status200, så et skift af værktøj ændrer låsefilen: init erstatter posten og beder dig committe ændringen.

Skift til en nyere version

  1. Læs, hvad der ændrede sig

    Status200s releases siger, hvad hver release ændrede, provideren inklusive. Providerens releases linker til ændringerne siden den forrige.

  2. Hent den

    Bash 
    terraform init -upgrade

    init -upgrade tager den nyeste version, din begrænsning tillader, viser den og opdaterer .terraform.lock.hcl. Begrænsningen ~> 14.0 tager hver 14.x-release; en ny hovedversion kræver en ny begrænsning.

  3. Planlæg, før du anvender

    Kør terraform plan, og anvend kun, når den er tom eller viser de ændringer, du forventer. Commit den opdaterede låsefil.

På en selv-hostet Status200 skal du opgradere Status200 først og derefter hæve slutningen af providerens interval.

Hvor koden bor

Provideren genereres ud fra Status200-API'et i Status200s hovedrepositorie, og hver version bygges fra den release, der udgav den. Dens eget repositorie, OneUptime/terraform-provider-status200, indeholder det, generatoren skrev, så ændringer laves i hovedrepositoriet: rapportér problemer, også dem i dokumentationen, på git.wilix.dev/status200/status200/issues.

Næste skridt

Selv-hostet opsætningVersionsintervallet for din egen Status200, og et spejl til offline-maskiner.OpenTofuDen samme provider og konfiguration, med tofu.Komplet vejledningGodkendelse, projektopbygning, datakilder, state og opgraderinger.FejlfindingAlmindelige fejl, og hvordan du retter dem.