Hoppa till innehåll
Dokumentation
Användning av register

Användning av register

Visa som Markdown

Status200-providern publiceras i Terraform Registry och OpenTofu Registry. terraform init och tofu init laddar ner den därifrån: det finns inget att installera för hand. Den här sidan tar upp vad som publiceras, hur versioner numreras och hur du byter till en nyare.

Vad som publicerasProvidern för varje plattform, dess referens och dess versioner.Hur versioner numrerasEn providers version är den Status200-release som publicerade den.LåsfilenVersionen och kontrollsummorna som varje maskin installerar.Byt till en nyare versionLäs vad som ändrades, ladda ner den och planera.

Vad som publiceras

Varje Status200-release genererar providern från Status200s eget API. När providern har ändrats publicerar releasen den, under releasens version, när den har klarat sina end-to-end-tester under Terraform och under OpenTofu:

flowchart TB R["En Status200-release"] --> G["Providern genereras<br/>från Status200s API"] G --> C{"Har providern<br/>ändrats?"} C -->|"ja"| P["Testad under Terraform<br/>och OpenTofu, sedan<br/>publicerad med<br/>releasens version"] C -->|"nej"| N["Ingen providerversion<br/>för den här releasen"] P --> I["terraform init<br/>och tofu init<br/>laddar ner den"]

Från en Status200-release till din terraform init

VadVar
Providern, för Linux, macOS, Windows, FreeBSD, OpenBSD och SolarisLaddas ner av terraform init och tofu init, med kontrollsummor som Status200 signerar
Referensen för varje resurs och datakälla, med vart och ett av dess attributRegistrets dokumentation, grupperad efter produkt: övervakare, statussidor, incidenter, jour och de andra
En guide för att använda providern med OpenTofuRegistrets guider
Varje version, den nyaste förstRegistrets versionslista

Referensen anger vad varje attribut är. Den här dokumentationen visar hur du använder dem tillsammans: börja från Terraform – Översikt.

Hur versioner numreras

En providers version är versionen av den Status200-release som publicerade den: provider 14.0.20 kom med Status200 14.0.20. En release vars provider inte ändrades publicerar ingen, så versionerna har luckor, och en begränsning som nämner en enda exakt version kan nämna en version som inte finns. Skriv ett intervall i stället:

Du använderBegränsningTerraform installerar
Status200 Cloud~> 14.0Den senaste 14.x-providern
Ett självhostat Status200Ett intervall som slutar vid ditt Status200s version, som >= 14.0, <= 14.0.40Den senaste providern som inte är nyare än ditt Status200

På ett självhostat Status200 kan en provider som är nyare än ditt Status200 skicka inställningar som ditt Status200 inte har än: Självhostad konfiguration visar hur du skriver dess intervall.

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

Källadressen nämner inget register: Terraform läser den från Terraform Registry, och OpenTofu från OpenTofu Registry, som publicerar samma versioner.

Låsfilen

terraform init registrerar versionen som den valde, och kontrollsummorna för sina nedladdningar, i .terraform.lock.hcl. Checka in den filen: varje maskin och varje CI-körning installerar då exakt den versionen, tills du väljer en annan. Kontrollsummorna täcker varje plattform som registret publicerar, så en låsfil fungerar lika bra för Linux-, macOS- och Windows-maskiner.

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

Låsfilen nämner registret. OpenTofu skriver registry.opentofu.org/status200/status200 där Terraform skriver registry.terraform.io/status200/status200, så ett byte av verktyg ändrar låsfilen: init ersätter posten och ber dig checka in ändringen.

Byt till en nyare version

  1. Läs vad som ändrades

    Status200s releaser säger vad varje release ändrade, providern inräknad. Providerns releaser länkar till ändringarna sedan den förra.

  2. Ladda ner den

    Bash 
    terraform init -upgrade

    init -upgrade tar den senaste versionen som din begränsning tillåter, visar den och uppdaterar .terraform.lock.hcl. Begränsningen ~> 14.0 tar varje 14.x-release; en ny huvudversion kräver en ny begränsning.

  3. Planera innan du tillämpar

    Kör terraform plan, och tillämpa bara när den är tom eller visar de ändringar som du väntar dig. Checka in den uppdaterade låsfilen.

På ett självhostat Status200 uppgraderar du Status200 först, och höjer sedan slutet av providerns intervall.

Var koden finns

Providern genereras från Status200-API:et i Status200s huvudrepo, och varje version byggs från den release som publicerade den. Dess eget repo, OneUptime/terraform-provider-status200, innehåller det som generatorn skrev, så ändringar görs i huvudrepot: rapportera problem, även de i dokumentationen, på git.wilix.dev/status200/status200/issues.

Nästa steg

Självhostad konfigurationVersionsintervallet för ditt eget Status200, och en spegel för maskiner utan internet.OpenTofuSamma provider och konfiguration, med tofu.Komplett guideAutentisering, projektupplägg, datakällor, state och uppgraderingar.FelsökningVanliga fel och hur du åtgärdar dem.