Gestione di una flotta
Seguire questi passaggi per eseguire un parco macchine con la CLI o con la console. Si noti che le flotte vengono eseguite non appena vengono create, quindi running una flotta e creating una flotta sono la stessa operazione.
Prima di iniziare
Per gestire con successo una flotta, assicuratevi di aver seguito le fasi di Preparazione alla gestione della flotta. È inoltre possibile utilizzare Code Engine per creare l'immagine di riferimento quando si crea la flotta.
Esecuzione di un parco macchine tramite la CLI
Utilizzare il seguente esempio di comando per eseguire un parco macchine. Questo comando consente ulteriori opzioni. Per un elenco completo di tutte le opzioni di comando disponibili, consultare il sito Documentazione CLI.
ibmcloud ce fleet run --name my-fleet --image icr.io/codeengine/helloworld --subnetpool-name my-pool --tasks-state-store mytaskstore --tasks 1
--name- Il nome della fleet. Questo valore deve essere unico per tutte le flotte dello stesso progetto. Se non viene specificato il nome della flotta, ne viene generato uno casuale.
--image- Il nome dell'immagine del container utilizzata per l'elaborazione delle attività. Questo campo è obbligatorio.
--subnetpool-name- Il nome del pool di sottoreti da utilizzare per il posizionamento della rete del parco.
--tasks-state-store- Specificare l'archivio dati persistente che memorizza lo stato delle attività del parco. Questo campo è obbligatorio.
--tasks- Il numero di task da eseguire.
Output di esempio.
Successfully created fleet with name 'my-fleet' and ID '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'
Run 'ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to check the fleet status.
Run 'ibmcloud ce fleet worker list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of provisioned workers.
Run 'ibmcloud ce fleet task list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of tasks.
OK
Esecuzione di un parco macchine tramite la console
Per eseguire un parco veicoli nella console Code Engine, procedere come segue.
- Aprire la Code Engine console.
- Fai clic su Avvia creazione.
- Seleziona un progetto dall'elenco dei progetti disponibili. Puoi anche crearne uno nuovo. Per gestire una flotta è necessario avere un progetto selezionato.
- Seleziona l'opzione per creare una flotta.
- Specificare un nome per la flotta. Assicuratevi che il nome sia unico per tutte le flotte del progetto.
- Specificare un'immagine del contenitore per la flotta, ad esempio
icr.io/codeengine/helloworld. Se si ha il proprio codice sorgente che si vuole trasformare in un'immagine del contenitore, vedere Pianificazione della compilazione. Per ulteriori informazioni sul codice utilizzato per questo esempio, vedere helloworld. - Seguire le istruzioni per configurare la flotta.
- Nella sezione Attività, configurare il metodo di specificazione delle attività per il parco macchine. Per ulteriori informazioni, consultare la sezione Specifiche del compito.
- Nella sezione Risorse e scalabilità, configurare le risorse dell'istanza e specificare come le istanze scalano verso l'alto o verso il basso.
- Nella sezione Posizionamento della rete, fare clic su Seleziona pool di sottoreti.
- Creare un nuovo pool di sottoreti per specificare la collocazione in rete dei lavoratori di questa flotta. Per ulteriori informazioni, vedere Lavorare con la connettività del pool di sottoreti in Code Engine.
- Oppure selezionare uno o più pool di sottoreti esistenti per specificare la collocazione in rete dei lavoratori di questa flotta.
- Fai clic su " Applica " per confermare la tua selezione.
- Nelle sezioni Variabili d'ambiente e Supporti di volume, aggiungere coppie chiave-valore, configmap o file aggiuntivi che possono essere utilizzati dal codice in esecuzione.
- Fare clic su Crea.
Specifiche del compito
Le flotte hanno sempre almeno un compito, ma possono averne un numero molto maggiore. È possibile specificare il numero di task da completare, il numero di istanze di task da eseguire alla volta e l'ordine di completamento dei task. Quando si esegue la flotta, i nodi worker scalano automaticamente in base al numero di attività da completare.
È possibile specificare le attività nei seguenti modi:
- Numero di task: Per eseguire un numero specifico di task, è possibile specificare qualsiasi numero intero positivo. Nella CLI, utilizzare l'opzione
--tasks. Nell'interfaccia utente, selezionare Numero di compiti e inserire il numero che si desidera eseguire. - Indice dell'attività: Per specificare un intervallo di attività, è possibile specificare un indice di attività che include un elenco separato da virgole di intervalli e numeri interi positivi, come
2-5,7-8,10. Nella CLI, utilizzare l'opzione--task-indexes. Nell'interfaccia utente, selezionare Indici attività e inserire l'intervallo. - File di task: Per eseguire compiti diversi con comandi o argomenti diversi, è possibile creare un file di specifica del compito che sostituisce la definizione dell'immagine. Il campo opzionale
idxpuò essere utilizzato per specificare un indice di attività personalizzato. Questo file deve essere formattato come JSONL. Nella CLI, specificare il file con l'opzione--tasks-from-local-fileo--tasks-from-cos-object. Nell'interfaccia utente, selezionare Attività da file e specificare il nome del file. Di seguito è riportato un esempio di righe che possono essere aggiunte a un file di specifiche del task.
Linee di esempio in un file di specifica dell'attività.
{ "cmds": ["my", "multipart", "command"], "args": ["arg1", "arg2"] }
{ "cmds": ["other", "cmd"], "args": ["arg"], "idx": "foo" }
{ "args": ["argA", "argB", "argC"], "idx": "bar" }
{ "cmds": ["just", "another", "command"], "idx": "1234" }
Eliminazione di una flotta tramite la CLI
Una flotta non viene cancellata automaticamente quando raggiunge il suo stato finale. Poiché esiste un limite di quota di 1000 flotte per progetto (vedere Quote di progetto ), eliminare la flotta tramite la CLI quando non è più necessaria.
Utilizzare il seguente esempio di comando per eliminare un parco macchine. Questo comando consente ulteriori opzioni. Per un elenco completo di tutte le opzioni di comando disponibili, consultare il sito Documentazione CLI.
ibmcloud ce fleet delete --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e
Eliminazione di un parco macchine tramite la console
Una flotta non viene cancellata automaticamente quando raggiunge il suo stato finale. Poiché esiste un limite di quota di 1000 flotte per progetto (vedere Quote di progetto ), eliminare la flotta tramite la CLI quando non è più necessaria.
Per eliminare un parco macchine nella console, procedere come segue.
- Vai alla pagina "Flotte":
- Selezionate il progetto dalla pagina Progetti della console Code Engine.
- Fare clic su Flotte per visualizzare l'elenco delle flotte esistenti.
- Andare alla riga con la flotta che si desidera rimuovere e fare clic sull'icona di cancellazione (cestino).
- Confermare l'eliminazione quando viene richiesto.