Hurtig start

Denne vejledning fører dig fra ingenting til et Status200-projekt, der administreres af Terraform, på omkring ti minutter. Du opretter en API-nøgle, peger Terraform mod dit projekt og anvender en etiket, en monitor, der tjekker dit website, og en privat statusside, der viser den. Derefter ændrer du en af dem og rydder op.

Før du begynder#

• Terraform 1.5 eller nyere, eller OpenTofu 1.6 eller nyere. Med OpenTofu kører du tofu alle steder, hvor denne vejledning kører terraform.
• Et Status200-projekt på status200.ru eller på din egen Status200, hvor du kan oprette API-nøgler.
• På Status200 Cloud abonnementet Growth eller højere. Et projekts API-nøgler virker kun på det.

Opret dine første ressourcer#

1. Opret en API-nøgle til projektet#

   Åbn Projektindstillinger → Avanceret → API-nøgler i Status200-dashboardet, og klik på Opret API-nøgle. Giv den et Navn, såsom terraform, og vælg Projektadministrator under Adgang: Terraform opretter, læser, ændrer og sletter alle slags poster, den administrerer, og Projektadministrator må gøre alt det. Til en mere begrænset nøgle vælger du Vælg tilladelser senere og tilføjer kun de tilladelser, du har brug for, på nøglens side.

   Nøglen udløber om et år. For at vælge en anden dato åbner du Flere felter, før du opretter den, eller ændrer datoen senere på nøglens side. Når nøglen er oprettet, åbner dens side: kopiér API-nøgle fra kortet API-nøgledetaljer.

2. Gør nøglen tilgængelig for Terraform#

   Læg nøglen i miljøvariablen STATUS200_API_KEY i den shell, du kører Terraform i, så den aldrig havner i en fil:

   LinuxmacOSWindows

   Linux

   Bash

   export STATUS200_API_KEY="<your-api-key>"

   macOS

   Bash

   export STATUS200_API_KEY="<your-api-key>"

   Windows

   PowerShell

   $env:STATUS200_API_KEY = "<your-api-key>"

3. Peg Terraform mod Status200#

   Opret en tom mappe, og i den en fil med navnet main.tf:

   main.tfHCL

   terraform {
     required_providers {
       oneuptime = {
         source  = "oneuptime/status200"
         version = "~> 14.0"
       }
     }
   }
   
   provider "oneuptime" {
     # The API key comes from STATUS200_API_KEY.
     # On a self-hosted Status200, add your Status200's address:
     # status200_url = "https://status200.example.com"
   }

   På en selv-hostet Status200 skal du læse Selv-hostet opsætning, før du vælger en providerversion.

4. Beskriv dine ressourcer#

   Tilføj disse blokke til main.tf. De læser to af de monitorstatusser, som alle projekter starter med, og opretter en etiket, en monitor, der tjekker https://example.com hvert femte minut (sæt dit eget website ind der), og en privat statusside, der viser monitoren:

   main.tfHCL

   data "status200_monitor_status" "operational" {
     name = "Operational"
   }
   
   data "status200_monitor_status" "offline" {
     name = "Offline"
   }
   
   resource "status200_label" "critical" {
     name        = "critical"
     description = "Resources that page on-call when down"
     color       = "#FF5733"
   }
   
   resource "status200_monitor" "homepage" {
     name                = "Homepage"
     description         = "Checks that the homepage responds"
     monitor_type        = "Website"
     monitoring_interval = "*/5 * * * *"
     labels              = [status200_label.critical.id]
   
     monitor_steps = [{
       monitor_destination      = "https://example.com"
       monitor_destination_type = "URL"
       request_type             = "GET"
   
       criteria = [
         {
           name                  = "Offline"
           description           = "The homepage does not respond"
           filter_condition      = "Any"
           change_monitor_status = true
           monitor_status_id     = data.status200_monitor_status.offline.id
   
           filters = [
             {
               check_on    = "Is Online"
               filter_type = "False"
             }
           ]
         },
         {
           name                  = "Online"
           description           = "The homepage responds"
           filter_condition      = "All"
           change_monitor_status = true
           monitor_status_id     = data.status200_monitor_status.operational.id
   
           filters = [
             {
               check_on    = "Is Online"
               filter_type = "True"
             }
           ]
         }
       ]
     }]
   }
   
   resource "status200_status_page" "internal" {
     name                  = "Internal Status"
     description           = "Status of our internal services"
     page_title            = "Service Status"
     is_public_status_page = false
   }
   
   resource "status200_status_page_resource" "homepage" {
     status_page_id = status200_status_page.internal.id
     monitor_id     = status200_monitor.homepage.id
     display_name   = "Homepage"
   }
   
   output "monitor_id" {
     value = status200_monitor.homepage.id
   }

   Monitorens monitor_steps siger, hvad den tjekker, og hvad hvert resultat betyder: efter hvert tjek sætter det første kriterium, der passer, dens status. Monitortrin forklarer hver del.

5. Planlæg og anvend#

   TerraformOpenTofu

   Terraform

   Bash

   terraform init
   terraform plan
   terraform apply

   OpenTofu

   Bash

   tofu init
   tofu plan
   tofu apply

   init henter provideren. Planen slutter med Plan: 4 to add, 0 to change, 0 to destroy. Skriv yes for at anvende den; når den er færdig, udskriver Terraform den nye monitors ID.

6. Tjek dashboardet#

   I Status200-dashboardet:

   • Monitorer viser Homepage med etiketten critical. Dens første tjek kommer inden for få minutter.
   • Statussider viser Internal Status, som viser Homepage.
   • Projektindstillinger → Grundlæggende → Etiketter viser critical i den farve, du har angivet.

   Kør terraform plan igen. Den svarer No changes.: Status200 indeholder præcis det, konfigurationen siger.

Ændr en ressource#

Ændr konfigurationen, ikke dashboardet. Sæt etikettens color til "#2ECC71" i main.tf, og planlæg og anvend derefter:

terraform plan
terraform apply

Planen slutter med Plan: 0 to add, 1 to change, 0 to destroy.: etiketten ændres på stedet. En ændring, som nogen laver i dashboardet på en ressource, Terraform administrerer, vises i den næste plan, og når du anvender den, bliver det, konfigurationen siger, sat tilbage.

Ryd op#

Hvis dette var en prøvetur, så slet det, konfigurationen har oprettet:

terraform destroy

Det sletter etiketten, monitoren, statussiden og dens ressource. De to monitorstatusser bliver: datakilderne læser dem kun.

Fejlfinding#

Næste skridt#