Variable Group

La sezione Variable Groups di Semaphore è il luogo in cui memorizzare variabili aggiuntive per un Inventory e deve essere in formato JSON.

Tutti i Task Template richiedono che sia definito un Variable Group, anche se vuoto.

Ansible riceve le variabili di un Variable Group come variabili extra da un file temporaneo in cui ogni valore che contiene un delimitatore Jinja2 ({{ … }}, {% … %} o {# … #}) è contrassegnato con !unsafe: un'espressione Jinja2 memorizzata in un Variable Group arriva al playbook in forma letterale e non viene valutata. I valori mantengono il loro tipo JSON: la stringa "2026.08" arriva al playbook come stringa, il numero 3 come numero. I secret del gruppo passati come variabili viaggiano in un file separato cifrato con Ansible Vault.

Creazione di un Variable Group

1. Fare clic sulla scheda Variable Group.
2. Fare clic sul pulsante Nuovo Variable Group.
3. Assegnare un nome al Variable Group e digitare o incollare variabili JSON valide. Se è necessario soltanto un Variable Group vuoto, digitare {}.

Aggiornamento di un Variable Group

1. Fare clic sulla scheda Variable Groups.
2. Fare clic sull'icona a forma di matita.
3. Apportare le modifiche e fare clic su salva.

Eliminazione di un Variable Group

Prima di rimuovere un Variable Group, è necessario rimuovere tutte le risorse ad esso collegate. Se non si è sicuri di quali risorse vengano utilizzate in un Variable Group, seguire i passaggi 1 e 2 riportati di seguito. Verranno mostrate le risorse in uso, con i collegamenti a tali risorse.

1. Fare clic sul Variable Group.
2. Fare clic sull'icona del cestino accanto al Variable Group.
3. Fare clic su Sì se si è sicuri di voler rimuovere il Variable Group.

Utilizzo dei Variable Group - Terraform/OpenTofu

Quando si desidera utilizzare una variabile o un segreto memorizzato in un Variable Group all'interno di un Task Template terraform, è necessario anteporre al nome il prefisso TF_VAR_ affinché lo script terraform lo utilizzi.

Esempio Passaggio della chiave API di Hetzner Cloud a un playbook OpenTofu/Terraform.

1. Fare clic su Variable Group
2. Fare clic su New Group
3. Fare clic sulla scheda Secrets
4. Aggiungere TF_VAR_hcloud_token e inserire il proprio secret nel campo nascosto
5. Fare clic su Salva

Il segreto TF_VAR_hcloud_token verrà richiamato come var.hcloud_token in hetzner.tf

terraform {
  required_providers {
    hcloud = {
      source  = "hetznercloud/hcloud"
      version = "~> 1.45"
    }
  }
}

# Declare the variable
variable "hcloud_token" {
  type        = string
  description = "Hetzner Cloud API token"
  sensitive   = true  # This prevents the token from being displayed in logs
}

provider "hcloud" {
  token = var.hcloud_token
}

# Create a new server running debian
resource "hcloud_server" "webserver" {
  name        = "webserver"
  image       = "ubuntu-24.04"
  server_type = "cpx11" 
  location    = "ash"
  ssh_keys = [ "mysshkey" ]
  public_net {
    ipv4_enabled = true
    ipv6_enabled = true
  }
}