# Registerbrug

Status200-provideren udgives i [Terraform Registry](https://registry.terraform.io/providers/status200/status200) og [OpenTofu Registry](https://search.opentofu.org/provider/status200/status200/latest). `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.

:::cards
- [Hvad der udgives](#hvad-der-udgives): Provideren til hver platform, dens reference og dens versioner.
- [Hvordan versioner nummereres](#hvordan-versioner-nummereres): En providers version er den Status200-release, der udgav den.
- [Låsefilen](#låsefilen): Den version og de checksums, hver maskine installerer.
- [Skift til en nyere version](#skift-til-en-nyere-version): Læ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:

```mermaid title="Fra en Status200-release til din terraform init"
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"]
```

| Hvad | Hvor |
| --- | --- |
| Provideren, til Linux, macOS, Windows, FreeBSD, OpenBSD og Solaris | Hentes af `terraform init` og `tofu init`, med checksums, som Status200 signerer |
| Referencen for hver ressource og datakilde, med hver af dens attributter | Registrets dokumentation, grupperet efter produkt: overvågninger, statussider, hændelser, vagter og de andre |
| En vejledning i at bruge provideren med OpenTofu | Registrets vejledninger |
| Hver version, nyeste først | Registrets versionsliste |

Referencen fortæller, hvad hver attribut er. Denne dokumentation viser, hvordan du bruger dem sammen: start fra [Terraform – Oversigt](/docs/terraform/index).

## 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 bruger | Begrænsning | Terraform installerer |
| --- | --- | --- |
| Status200 Cloud | `~> 14.0` | Den nyeste 14.x-provider |
| En selv-hostet Status200 | Et interval, der slutter ved din Status200s version, som `>= 14.0, <= 14.0.40` | Den 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](/docs/terraform/self-hosted#vælg-providerversionen) viser, hvordan du skriver dens interval.

```hcl title="main.tf"
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.

```hcl title=".terraform.lock.hcl"
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

:::steps
### Læs, hvad der ændrede sig

[Status200s releases](https://git.wilix.dev/status200/status200/releases) siger, hvad hver release ændrede, provideren inklusive. [Providerens releases](https://github.com/OneUptime/terraform-provider-status200/releases) linker til ændringerne siden den forrige.

### 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.

### 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](https://git.wilix.dev/status200/status200), og hver version bygges fra den release, der udgav den. Dens eget repositorie, [OneUptime/terraform-provider-status200](https://github.com/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](https://git.wilix.dev/status200/status200/issues).

## Næste skridt

:::cards
- [Selv-hostet opsætning](/docs/terraform/self-hosted): Versionsintervallet for din egen Status200, og et spejl til offline-maskiner.
- [OpenTofu](/docs/terraform/opentofu): Den samme provider og konfiguration, med `tofu`.
- [Komplet vejledning](/docs/terraform/complete-guide): Godkendelse, projektopbygning, datakilder, state og opgraderinger.
- [Fejlfinding](/docs/terraform/troubleshooting): Almindelige fejl, og hvordan du retter dem.
:::