Passa al contenuto principale
Versione: 0.5.1

Gestione Job Pianificati

I job pianificati ti permettono di automatizzare attività che vengono eseguite a orari specifici o su pianificazioni ricorrenti usando espressioni CRON.

Comandi Disponibili​

  • acloud schedule job create - Crea un nuovo job pianificato
  • acloud schedule job list - Elenca tutti i job pianificati
  • acloud schedule job get - Ottieni i dettagli di un job specifico
  • acloud schedule job update - Aggiorna proprietà job
  • acloud schedule job delete - Elimina un job pianificato

Tipi di Job​

Job OneShot​

I job OneShot vengono eseguiti una volta a una data e ora specificate. Sono utili per:

  • Attività di manutenzione una tantum
  • Deployment pianificati
  • Automazione basata sul tempo

Job Ricorrenti​

I job ricorrenti vengono eseguiti su una pianificazione definita da un'espressione CRON. Sono utili per:

  • Backup giornalieri
  • Report settimanali
  • Manutenzione periodica

Crea Job OneShot​

Crea un job che viene eseguito una volta a un orario specifico.

Utilizzo​

acloud schedule job create --name <name> --region <region> --job-type "OneShot" --schedule-at <datetime> --step-resource-uri <uri> [flags]

Flag Richiesti​

  • --name - Nome per il job
  • --region - Codice regione (es. "ITBG-Bergamo")
  • --job-type - Deve essere "OneShot"
  • --schedule-at - Data e ora in cui il job dovrebbe essere eseguito (formato RFC3339, es. "2026-12-31T23:59:59Z")

Flag Step (richiesti dall'API)​

L'API schedule richiede almeno uno step con un URI risorsa valido. Lo step definisce su quale risorsa il job agisce e quale azione eseguire.

  • --step-resource-uri - URI della risorsa su cui agire (es. /projects/<pid>/providers/Aruba.Compute/cloudServers/<id>)
  • --step-action-uri - Azione da invocare sulla risorsa (es. poweroff, start)
  • --step-http-verb - Verbo HTTP per l'azione dello step (default: POST)
  • --step-name - Nome visualizzato per lo step

Flag Opzionali​

  • --project-id - ID progetto (usa il contesto se non specificato)
  • --enabled - Abilita il job (default: true)
  • --tags - Tag (separati da virgola)

Esempio​

acloud schedule job create \
  --name "scheduled-poweroff" \
  --region "ITBG-Bergamo" \
  --job-type "OneShot" \
  --schedule-at "2026-12-31T23:59:59Z" \
  --step-resource-uri "/projects/<project-id>/providers/Aruba.Compute/cloudServers/<server-id>" \
  --step-action-uri "poweroff" \
  --step-http-verb "POST" \
  --step-name "e2e-step" \
  --tags "maintenance,oneshot"

Nota: --step-resource-uri deve puntare a un tipo di risorsa registrata con lo scheduler (es. cloud server). L'API restituisce "Not found configuration for typology" se il tipo di risorsa non è registrato.

Crea Job Ricorrente​

Crea un job che viene eseguito su una pianificazione ricorrente.

Utilizzo​

acloud schedule job create --name <name> --region <region> --job-type "Recurring" --cron <cron-expression> --execute-until <datetime> --step-resource-uri <uri> [flags]

Flag Richiesti​

  • --name - Nome per il job
  • --region - Codice regione (es. "ITBG-Bergamo")
  • --job-type - Deve essere "Recurring"
  • --cron - Espressione CRON che definisce la pianificazione
  • --execute-until - Data di fine fino alla quale il job può essere eseguito (formato RFC3339)

Flag Step (richiesti dall'API)​

Stessi flag degli OneShot: --step-resource-uri, --step-action-uri, --step-http-verb, --step-name.

Flag Opzionali​

  • --project-id - ID progetto (usa il contesto se non specificato)
  • --enabled - Abilita o disabilita il job (default: true)
  • --tags - Tag (separati da virgola)

Esempio​

acloud schedule job create \
  --name "daily-poweroff" \
  --region "ITBG-Bergamo" \
  --job-type "Recurring" \
  --cron "0 0 * * *" \
  --execute-until "2027-01-01T00:00:00Z" \
  --step-resource-uri "/projects/<project-id>/providers/Aruba.Compute/cloudServers/<server-id>" \
  --step-action-uri "poweroff" \
  --step-http-verb "POST" \
  --step-name "daily-step" \
  --tags "backup,daily"

Formato Espressione CRON​

Le espressioni CRON seguono il formato standard:

┌───────────── minuto (0 - 59)
│ ┌───────────── ora (0 - 23)
│ │ ┌───────────── giorno del mese (1 - 31)
│ │ │ ┌───────────── mese (1 - 12)
│ │ │ │ ┌───────────── giorno della settimana (0 - 6) (Domenica a Sabato)
│ │ │ │ │
* * * * *

Esempi CRON Comuni​

  • 0 0 * * * - Ogni giorno a mezzanotte
  • 0 */6 * * * - Ogni 6 ore
  • 0 0 1 * * - Primo giorno di ogni mese a mezzanotte
  • 0 0 * * 0 - Ogni domenica a mezzanotte
  • 0 0 1 1 * - 1 gennaio a mezzanotte (annuale)
  • */15 * * * * - Ogni 15 minuti

Elenca Job​

Elenca tutti i job pianificati nel tuo progetto.

Utilizzo​

acloud schedule job list [flags]

Flag​

  • --project-id - ID progetto (usa il contesto se non specificato)

Esempio​

acloud schedule job list

Ottieni Dettagli Job​

Recupera informazioni dettagliate su un job specifico.

Utilizzo​

acloud schedule job get <job-id> [flags]

Argomenti​

  • job-id (richiesto): L'ID univoco del job

Flag​

  • --project-id - ID progetto (usa il contesto se non specificato)

Esempio​

acloud schedule job get 69455aa70d0972656501d45d

Aggiorna Job​

Aggiorna proprietà job come nome, stato abilitato e tag.

Utilizzo​

acloud schedule job update <job-id> [flags]

Argomenti​

  • job-id (richiesto): L'ID univoco del job

Flag​

  • --project-id - ID progetto (usa il contesto se non specificato)
  • --name - Nuovo nome per il job
  • --enabled - Abilita o disabilita il job
  • --tags - Nuovi tag (separati da virgola)

Esempio​

acloud schedule job update 69455aa70d0972656501d45d \
  --name "updated-job-name" \
  --enabled false \
  --tags "updated,disabled"

Elimina Job​

Elimina un job pianificato.

Utilizzo​

acloud schedule job delete <job-id> [--yes] [flags]

Argomenti​

  • job-id (richiesto): L'ID univoco del job

Flag​

  • --project-id - ID progetto (usa il contesto se non specificato)
  • --yes, -y - Salta il prompt di conferma

Esempio​

acloud schedule job delete 69455aa70d0972656501d45d --yes

Best Practices​

  • Usa nomi descrittivi per i job
  • Imposta date execute-until appropriate per job ricorrenti
  • Testa espressioni CRON prima di creare job
  • Monitora lo stato di esecuzione dei job
  • Usa tag per organizzare e filtrare job
  • Disabilita job invece di eliminarli quando temporaneamente non necessari

Risorse Correlate​