Gå til innhold
Dokumentasjon
Registerbruk

Registerbruk

Vis som Markdown

Status200-provideren publiseres i Terraform Registry og OpenTofu Registry. terraform init og tofu init laster den ned derfra: det er ingenting å installere for hånd. Denne siden dekker hva som publiseres, hvordan versjoner nummereres, og hvordan du går over til en nyere.

Hva som publiseresProvideren for hver plattform, referansen og versjonene.Hvordan versjoner nummereresVersjonen til en provider er Status200-releasen som publiserte den.LåsefilenVersjonen og sjekksummene hver maskin installerer.Gå over til en nyere versjonLes hva som endret seg, last den ned og planlegg.

Hva som publiseres

Hver Status200-release genererer provideren fra Status200s eget API. Når provideren har endret seg, publiserer releasen den, under releasens versjon, når den har bestått ende-til-ende-testene sine under Terraform og under OpenTofu:

flowchart TB R["En Status200-release"] --> G["Provideren genereres<br/>fra Status200s API"] G --> C{"Har provideren<br/>endret seg?"} C -->|"ja"| P["Testet under Terraform<br/>og OpenTofu, deretter<br/>publisert med<br/>releasens versjon"] C -->|"nei"| N["Ingen providerversjon<br/>for denne releasen"] P --> I["terraform init<br/>og tofu init<br/>laster den ned"]

Fra en Status200-release til terraform init

HvaHvor
Provideren, for Linux, macOS, Windows, FreeBSD, OpenBSD og SolarisLastes ned av terraform init og tofu init, med sjekksummer som Status200 signerer
Referansen for hver ressurs og datakilde, med hvert av attributteneRegisterets dokumentasjon, gruppert etter produkt: overvåkere, statussider, hendelser, vakt og de andre
En guide til å bruke provideren med OpenTofuRegisterets guider
Hver versjon, nyeste førstRegisterets versjonsliste

Referansen forteller hva hvert attributt er. Denne dokumentasjonen viser hvordan du bruker dem sammen: begynn med Terraform – Oversikt.

Hvordan versjoner nummereres

Versjonen til en provider er versjonen til Status200-releasen som publiserte den: provider 14.0.20 kom med Status200 14.0.20. En release der provideren ikke endret seg, publiserer ingen, så versjonene har hull, og en begrensning som nevner én eksakt versjon, kan nevne en versjon som ikke finnes. Skriv et intervall i stedet:

Du brukerBegrensningTerraform installerer
Status200 Cloud~> 14.0Den nyeste 14.x-provideren
En selv-hostet Status200Et intervall som slutter ved versjonen til installasjonen din, som >= 14.0, <= 14.0.40Den nyeste provideren som ikke er nyere enn installasjonen din

På en selv-hostet Status200 kan en provider som er nyere enn installasjonen din, sende innstillinger installasjonen din ikke har ennå: Selv-hostet oppsett viser hvordan du skriver intervallet.

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

Kildeadressen nevner ikke noe register: Terraform leser den fra Terraform Registry, og OpenTofu fra OpenTofu Registry, som publiserer de samme versjonene.

Låsefilen

terraform init registrerer versjonen den valgte, og sjekksummene for nedlastingene, i .terraform.lock.hcl. Commit den filen: hver maskin og hver CI-kjøring installerer da nøyaktig den versjonen, til du velger en annen. Sjekksummene dekker hver plattform registeret publiserer, så én låsefil fungerer like 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 nevner registeret. OpenTofu skriver registry.opentofu.org/status200/status200 der Terraform skriver registry.terraform.io/status200/status200, så et bytte av verktøy endrer låsefilen: init erstatter oppføringen, og ber deg committe endringen.

Gå over til en nyere versjon

  1. Les hva som endret seg

    Status200s releaser sier hva hver release endret, provideren inkludert. Providerens releaser lenker til endringene siden den forrige.

  2. Last den ned

    Bash 
    terraform init -upgrade

    init -upgrade tar den nyeste versjonen begrensningen din tillater, viser den og oppdaterer .terraform.lock.hcl. Begrensningen ~> 14.0 tar hver 14.x-release; en ny hovedversjon krever en ny begrensning.

  3. Planlegg før du tar i bruk

    Kjør terraform plan, og ta bare i bruk når den er tom eller viser endringene du venter. Commit den oppdaterte låsefilen.

På en selv-hostet Status200 oppgraderer du Status200 først, og hever deretter slutten av providerens intervall.

Hvor koden ligger

Provideren genereres fra Status200-API-et i Status200s hovedrepositorium, og hver versjon bygges fra releasen som publiserte den. Dens eget repositorium, OneUptime/terraform-provider-status200, inneholder det generatoren skrev, så endringer gjøres i hovedrepositoriet: rapporter problemer, også de i dokumentasjonen, på git.wilix.dev/status200/status200/issues.

Neste steg

Selv-hostet oppsettVersjonsintervallet for din egen Status200, og et speil for frakoblede maskiner.OpenTofuDen samme provideren og konfigurasjonen, med tofu.Komplett guideAutentisering, prosjektoppsett, datakilder, state og oppgraderinger.FeilsøkingVanlige feil og hvordan du retter dem.