Utilizzo dell'API REST Slurm per la gestione dei lavori in PCS AWS - AWS PC
Panoramica dell'API REST SlurmPrerequisitiProcedura

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo dell'API REST Slurm per la gestione dei lavori in PCS AWS

Panoramica dell'API REST Slurm

L'API REST di Slurm fornisce l'accesso programmatico alle funzioni di gestione dei cluster tramite richieste HTTP. La comprensione di queste caratteristiche chiave ti aiuterà a utilizzare efficacemente l'API con PCS: AWS

  • Protocollo di accesso: l'API utilizza HTTP (non HTTPS) per la comunicazione all'interno della rete privata del cluster.

  • Dettagli di connessione: accedi all'API utilizzando l'indirizzo IP privato del cluster e la slurmrestd porta (in genere 6820). Il formato URL di base completo èhttp://<privateIpAddress>:6820.

  • Controllo delle versioni dell'API: La versione dell'API corrisponde all'installazione di Slurm. Per Slurm 25.05, usa la versione v0.0.43. Il numero di versione cambia con ogni versione di Slurm. Puoi trovare le versioni delle API attualmente supportate nelle note di rilascio di Slurm.

  • Struttura dell'URL: La struttura dell'URL per l'API REST di Slurm è. http://<privateIpAddress>:<port>/<api-version>/<endpoint> Informazioni dettagliate sull'utilizzo degli endpoint dell'API REST sono disponibili nella documentazione di Slurm.

Per informazioni specifiche sull'utilizzo dell'API REST di Slurm, consulta la documentazione Slurm del client REST.

Prerequisiti

Prima di utilizzare l'API REST di Slurm, assicurati di avere:

  • Configurazione del cluster: cluster AWS PCS con Slurm 25.05+ e API REST abilitate.

  • Autenticazione: token JWT valido con affermazioni di identità utente corrette.

  • Accesso alla rete: connettività all'interno del VPC del cluster con un gruppo di sicurezza che consente la porta 6820.

Procedura

Per inviare un lavoro utilizzando l'API REST

  1. Crea una richiesta di invio di lavoro con i parametri richiesti:

    {
  "job": {
    "name": "my-job",
    "partition": "compute",
    "nodes": 1,
    "tasks": 1,
    "script": "#!/bin/bash\necho 'Hello from Slurm REST API'",
    "environment": ["PATH=/usr/local/bin:/usr/bin:/bin"]
  }
}

  2. Invia il lavoro utilizzando una richiesta HTTP POST:

    curl -X POST \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '<job-json>' \
  https://<privateIpAddress>:6820/slurm/v0.0.43/job/submit

  3. Annota l'ID del lavoro restituito nella risposta a scopo di monitoraggio.

Per monitorare lo stato del lavoro

  1. Ottieni informazioni su un lavoro specifico:

    curl -X GET -H "Authorization: Bearer <jwt>" \
    https://<privateIpAddress>:6820/slurm/v0.0.43/job/<job-id>

  2. Elenca tutti i lavori per l'utente autenticato:

    curl -X GET -H "Authorization: Bearer <jwt>" \
    https://<privateIpAddress>:6820/slurm/v0.0.43/jobs
Come annullare un processo

  • Invia una richiesta DELETE per annullare un lavoro specifico:

    curl -X DELETE -H "Authorization: Bearer <jwt>" \
    https://<privateIpAddress>:6820/slurm/v0.0.43/job/<job-id>