Questa pagina è stata tradotta dall'API Cloud Translation.

Crea ed esegui un job di esempio

Scopri come creare ed eseguire un job di elaborazione batch di esempio che esegue la transcodifica dei video utilizzando Batch per Google Cloud.

Per seguire le indicazioni dettagliate per questa attività direttamente nella Google Cloud console, fai clic su Procedura guidata:

Procedura guidata

Prima di iniziare

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

Create or select a Google Cloud project.

Create a Google Cloud project:
```
gcloud projects create PROJECT_ID
```
Replace PROJECT_ID with a name for the Google Cloud project you are creating.
Select the Google Cloud project that you created:
```
gcloud config set project PROJECT_ID
```
Replace PROJECT_ID with your Google Cloud project name.

Make sure that billing is enabled for your Google Cloud project.

Enable the Batch, Compute Engine, Logging and Cloud Storage APIs:

gcloud services enable batch.googleapis.com compute.googleapis.com logging.googleapis.com storage.googleapis.com

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

Create or select a Google Cloud project.

Create a Google Cloud project:
```
gcloud projects create PROJECT_ID
```
Replace PROJECT_ID with a name for the Google Cloud project you are creating.
Select the Google Cloud project that you created:
```
gcloud config set project PROJECT_ID
```
Replace PROJECT_ID with your Google Cloud project name.

Make sure that billing is enabled for your Google Cloud project.

Enable the Batch, Compute Engine, Logging and Cloud Storage APIs:

gcloud services enable batch.googleapis.com compute.googleapis.com logging.googleapis.com storage.googleapis.com

Assicurati che tu e il account di servizio del job disponiate delle autorizzazioni necessarie per completare questo tutorial. Questo tutorial utilizza il service account predefinito per un job, ovvero l'account di servizio Compute Engine predefinito.
Nota: se hai creato un nuovo progetto, questo passaggio non è necessario:
- In qualità di autore del progetto, ti viene concesso automaticamente il ruolo IAM Proprietario (roles/owner), che dispone già di tutte le autorizzazioni richieste per questo tutorial.
- In un nuovo progetto, al account di servizio predefinito di Compute Engine viene concesso automaticamente il ruolo Editor (roles/editor), che dispone già di tutte le autorizzazioni richieste per questo tutorial.
- Per ottenere le autorizzazioni necessarie per completare questo tutorial, chiedi all'amministratore di concederti i seguenti ruoli IAM:
  - Per creare, visualizzare ed eliminare i lavori:
    - Batch Job Editor (roles/batch.jobsEditor) sul progetto
    - Utente service account (roles/iam.serviceAccountUser) sul account di servizio predefinito di Compute Engine
  - Per creare, visualizzare ed eliminare i bucket Cloud Storage: Amministratore archiviazione (roles/storage.admin) del progetto
  - Per visualizzare i log dei job: Visualizzatore log (roles/logging.viewer) sul progetto
  Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
  
  Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
- Per assicurarti che l'account di servizio predefinito di Compute Engine disponga delle autorizzazioni necessarie per completare questo tutorial, chiedi all'amministratore di concedere all'account di servizio predefinito di Compute Engine i seguenti ruoli IAM:
  
  Importante:devi concedere questi ruoli all'account di servizio predefinito di Compute Engine, non al tuo account utente. Se i ruoli non vengono concessi all'entità corretta, potrebbero verificarsi errori di autorizzazione.
  - Batch Agent Reporter (roles/batch.agentReporter) sul progetto
  - Per consentire ai job di accedere ai bucket Cloud Storage: Amministratore Storage (roles/storage.admin) sul progetto
  - Per consentire ai job di generare log in Logging: Scrittore log (roles/logging.logWriter) sul progetto

Clona il repository Git di Batch nella directory corrente:

git clone https://github.com/GoogleCloudPlatform/batch-samples.git

Vai alla directory transcoding:
```
cd batch-samples/transcoding/
```

Prepara gli input del job

Crea un bucket Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME
```
Sostituisci BUCKET_NAME con un nome univoco a livello globale per il bucket.

Attenzione: non includere informazioni sensibili nel nome di un bucket Cloud Storage. Un nome bucket è globale e visibile pubblicamente.

L'output è simile al seguente:
```
Creating gs://BUCKET_NAME/...
```

Copia lo script transcode.sh e la cartella contenente i file video nel tuo bucket Cloud Storage:

gcloud storage cp -R transcode.sh input gs://BUCKET_NAME

L'output è simile al seguente:

Copying file://transcode.sh to gs://BUCKET_NAME/transcode.sh
Copying file://input/video-2.mp4 to gs://BUCKET_NAME/input/video-2.mp4
Copying file://input/video-1.mp4 to gs://BUCKET_NAME/input/video-1.mp4
Copying file://input/video-0.mp4 to gs://BUCKET_NAME/input/video-0.mp4
  Completed files 4/4 | 37.5MiB/37.5MiB

Average throughput: 48.4MiB/s

Crea un job

In un editor di testo di tua scelta, apri il file di configurazione job.json.

Imposta il valore del campo remotePath sul nome del tuo bucket Cloud Storage:

{
  "taskGroups": [
    {
      "taskSpec": {
        "runnables": [
          {
            "script": {
              "text": "bash /mnt/share/transcode.sh"
            }
          }
        ],
        "computeResource": {
          "cpuMilli": 2000,
          "memoryMib": 2048
        },
        "volumes": [
          {
            "gcs": {
              "remotePath": "BUCKET_NAME"
            },
            "mountPath": "/mnt/share"
          }
        ],
        "maxRetryCount": 2,
        "maxRunDuration": "600s"
      },
      "taskCount": 3,
      "parallelism": 3
    }
  ],
  "allocationPolicy": {
    "instances": [
      {
        "policy": {
          "machineType": "n2d-standard-4",
          "provisioningModel": "SPOT"
        }
      }
    ]
  },
  "labels": {
    "department": "creative",
    "env": "testing"
  },
  "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

Salva le modifiche e chiudi l'editor di testo.
Crea il job transcode:
```
gcloud batch jobs submit transcode \
    --config=job.json \
    --location=us-central1
```
L'output è simile al seguente:
```
Job transcode-7a1654ca-211c-40e8-b0fb-8a00 was successfully submitted.
...
```
Il job esegue tre attività contemporaneamente. Ogni attività esegue lo script transcode.sh, che codifica uno dei tre file video e lo carica nel bucket Cloud Storage.

Monitorare il job

Nella console Google Cloud , vai alla pagina Elenco dei job.

Vai all'elenco di job
Nella colonna Nome job, fai clic su transcode.

Viene visualizzata la pagina Dettagli job.
Fai clic sulla scheda Eventi.

Nella sezione Elenco di eventi puoi monitorare lo stato del job transcode. Il tempo impiegato dal job per completare le fasi di inserimento in coda, pianificazione ed esecuzione varia in base a diversi fattori. Per questo esempio, il job dovrebbe venire completato in circa 5 minuti.
(Facoltativo) Per aggiornare la pagina, fai clic su Aggiorna.

Prima di procedere con il passaggio successivo, assicurati che lo stato del job sia impostato su Riuscito. Se il job non va a buon fine, consulta la sezione Risoluzione dei problemi.

Visualizza i video codificati

Nella console Google Cloud , vai alla pagina Bucket.

Vai a Bucket
Nella colonna Nome, fai clic su BUCKET_NAME.

Viene visualizzata la pagina Dettagli bucket.
Nella colonna Nome, fai clic su output/, quindi su uno dei file video codificati.

Viene visualizzata la pagina Dettagli oggetto.
Per visualizzare il video codificato, fai clic su Anteprima, quindi su Riproduci.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il progetto Google Cloud con le risorse.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione è quello di eliminare il progetto utilizzato in questo tutorial.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività descritte in questo documento, quando lo elimini, elimini anche tutto il lavoro che hai svolto nel progetto.
Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

Elimina singole risorse

Se vuoi continuare a utilizzare il progetto attuale, elimina le singole risorse utilizzate in questo tutorial.

Eliminare il job

Al termine dell'esecuzione del job Batch, elimina il job transcode:

gcloud batch jobs delete transcode \
    --location=us-central1

L'output è simile al seguente:

Job projects/example-project/locations/us-central1/jobs/transcode deletion is in progress

Se elimini un job, vengono eliminati anche i dettagli e la cronologia del job. I log del job vengono eliminati automaticamente al termine del periodo di conservazione dei log di Cloud Logging.

Elimina il bucket

Se non hai più bisogno del bucket Cloud Storage che hai utilizzato in questo tutorial e dei relativi contenuti, eliminalo:

gcloud storage rm gs://BUCKET_NAME \
    --recursive

L'output è simile al seguente:

Removing objects:
Removing gs://BUCKET_NAME/input/video-0.mp4#1694788495332395...
Removing gs://BUCKET_NAME/input/video-2.mp4#1694788495296173...
Removing gs://BUCKET_NAME/input/video-1.mp4#1694788495228839...
Removing gs://BUCKET_NAME/output/video-0.mp4#1694788495332395...
Removing gs://BUCKET_NAME/output/video-2.mp4#1694788495296173...
Removing gs://BUCKET_NAME/output/video-1.mp4#1694788495228839...
Removing gs://BUCKET_NAME/transcode.sh#1694788495039427...
  Completed 4/4
Removing Buckets:
Removing gs://BUCKET_NAME/...
  Completed 1/1

Elimina il repository Git

Se non hai più bisogno del repository Batch git che hai clonato per questo tutorial, puoi eliminarlo:

cd ../../ && rm -rf batch-samples

Passaggi successivi

Scopri come iniziare a utilizzare Batch.
Scopri di più sulla creazione e l'esecuzione dei job.