feat(serverless_jobs): migrate to v1alpha2 (#5328)

Mia-Cross · scaleway-bot · web-flow · commit b82ddce60e1a · 2026-02-11T09:54:28.000Z
Co-authored-by: Scaleway Bot &lt;github@scaleway.com&gt;
diff --git a/cmd/scw/testdata/test-all-usage-jobs-definition-create-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-definition-create-usage.golden
@@ -7,11 +7,12 @@ USAGE:
 
 ARGS:
   name=<generated>                Name of the job definition
-  cpu-limit                       CPU limit of the job
+  cpu-limit                       CPU limit of the job (in mvCPU)
   memory-limit                    Memory limit of the job (in MiB)
   [local-storage-capacity]        Local storage capacity of the job (in MiB)
   image-uri                       Image to use for the job
-  [command]                       Startup command. If empty or not defined, the image's default command is used.
+  [startup-command.{index}]       Job startup command. Overrides the default defined in the job image.
+  [args.{index}]                  Job arguments. Overrides the default arguments defined in the job image.
   [project-id]                    Project ID to use. If none is passed the default project ID will be used
   [environment-variables.{key}]   Environment variables of the job
   [description]                   Description of the job
@@ -20,6 +21,9 @@ ARGS:
   [cron-schedule.timezone]        
   [region=fr-par]                 Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
+DEPRECATED ARGS:
+  [command]   Startup command. If empty or not defined, the image's default command is used.
+
 FLAGS:
   -h, --help                help for create
       --list-sub-commands   List all subcommands
diff --git a/cmd/scw/testdata/test-all-usage-jobs-definition-start-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-definition-start-usage.golden
@@ -1,17 +1,21 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Run an existing job definition by its unique identifier. This will create a new job run.
+Run an existing job definition using its unique identifier and create a new job run.
 
 USAGE:
   scw jobs definition start <job-definition-id ...> [arg=value ...]
 
 ARGS:
   job-definition-id               UUID of the job definition to start
-  [command]                       Contextual startup command for this specific job run
+  [startup-command.{index}]       Contextual startup command for this specific job run.
+  [args.{index}]                  Contextual arguments for this specific job run.
   [environment-variables.{key}]   Contextual environment variables for this specific job run
   [replicas]                      Number of jobs to run
   [region=fr-par]                 Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
+DEPRECATED ARGS:
+  [command]   Contextual startup command for this specific job run.
+
 FLAGS:
   -h, --help                help for start
       --list-sub-commands   List all subcommands
diff --git a/cmd/scw/testdata/test-all-usage-jobs-definition-update-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-definition-update-usage.golden
@@ -8,18 +8,22 @@ USAGE:
 ARGS:
   job-definition-id               UUID of the job definition to update
   [name]                          Name of the job definition
-  [cpu-limit]                     CPU limit of the job
+  [cpu-limit]                     CPU limit of the job (in mvCPU)
   [memory-limit]                  Memory limit of the job (in MiB)
   [local-storage-capacity]        Local storage capacity of the job (in MiB)
   [image-uri]                     Image to use for the job
-  [command]                       Startup command
+  [startup-command.{index}]       Job startup command. Overrides the default defined in the job image.
+  [args.{index}]                  Job arguments. Overrides the default arguments defined in the job image.
   [environment-variables.{key}]   Environment variables of the job
   [description]                   Description of the job
   [job-timeout]                   Timeout of the job in seconds
   [cron-schedule.schedule]        
   [cron-schedule.timezone]        
   [region=fr-par]                 Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
+DEPRECATED ARGS:
+  [command]   Startup command. If empty or not defined, the image's default command is used.
+
 FLAGS:
   -h, --help                help for update
       --list-sub-commands   List all subcommands
diff --git a/cmd/scw/testdata/test-all-usage-jobs-definition-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-definition-usage.golden
@@ -8,7 +8,7 @@ AVAILABLE COMMANDS:
   delete      Delete an existing job definition by its unique identifier
   get         Get a job definition by its unique identifier
   list        List all your job definitions with filters
-  start       Run an existing job definition by its unique identifier. This will create a new job run
+  start       Run an existing job definition using its unique identifier and create a new job run
   update      Update an existing job definition associated with the specified unique identifier
 
 FLAGS:
diff --git a/cmd/scw/testdata/test-all-usage-jobs-run-list-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-run-list-usage.golden
@@ -9,8 +9,9 @@ ARGS:
   [order-by]             (created_at_asc | created_at_desc)
   [job-definition-id]   
   [project-id]          
-  [state]                (unknown_state | queued | scheduled | running | succeeded | failed | canceled | internal_error)
-  [states.{index}]       (unknown_state | queued | scheduled | running | succeeded | failed | canceled | internal_error)
+  [state]                (unknown_state | initialized | validated | queued | running | succeeded | failed | interrupting | interrupted)
+  [states.{index}]       (unknown_state | initialized | validated | queued | running | succeeded | failed | interrupting | interrupted)
+  [reasons.{index}]      (unknown_reason | invalid_request | timeout | cancellation | technical_error | image_not_found | invalid_image | memory_usage_exceeded | storage_usage_exceeded | exited_with_error | secret_disabled | secret_not_found | quota_exceeded)
   [organization-id]     
   [region=fr-par]       Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw | all)
 
diff --git a/cmd/scw/testdata/test-all-usage-jobs-run-stop-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-run-stop-usage.golden
@@ -1,9 +1,9 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Stop a job run by its unique identifier.
+Stop a job run using its unique identifier.
 
 USAGE:
-  scw jobs run stop <job-run-id ...> [arg=value ...]
+  scw jobs run stop [arg=value ...]
 
 ARGS:
   job-run-id        UUID of the job run to stop
diff --git a/cmd/scw/testdata/test-all-usage-jobs-run-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-run-usage.golden
@@ -6,7 +6,7 @@ USAGE:
 AVAILABLE COMMANDS:
   get         Get a job run by its unique identifier
   list        List all job runs with filters
-  stop        Stop a job run by its unique identifier
+  stop        Stop a job run using its unique identifier
   wait        Wait for a job run to reach a stable state
 
 FLAGS:
diff --git a/cmd/scw/testdata/test-all-usage-jobs-secret-delete-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-secret-delete-usage.golden
@@ -6,9 +6,8 @@ USAGE:
   scw jobs secret delete [arg=value ...]
 
 ARGS:
-  job-definition-id   UUID of the job definition
-  secret-id           UUID of the secret reference within the job
-  [region=fr-par]     Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
+  secret-id         UUID of the secret reference within the job
+  [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
 FLAGS:
   -h, --help                help for delete
diff --git a/cmd/scw/testdata/test-all-usage-jobs-secret-get-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-secret-get-usage.golden
@@ -6,9 +6,8 @@ USAGE:
   scw jobs secret get [arg=value ...]
 
 ARGS:
-  job-definition-id   UUID of the job definition
-  secret-id           UUID of the secret reference within the job
-  [region=fr-par]     Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
+  secret-id         UUID of the secret reference within the job
+  [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | nl-ams | pl-waw)
 
 FLAGS:
   -h, --help                help for get
diff --git a/cmd/scw/testdata/test-all-usage-jobs-secret-update-usage.golden b/cmd/scw/testdata/test-all-usage-jobs-secret-update-usage.golden
@@ -6,7 +6,6 @@ USAGE:
   scw jobs secret update [arg=value ...]
 
 ARGS:
-  job-definition-id          UUID of the job definition
   secret-id                  UUID of the secret reference within the job
   [secret-manager-version]   Version of the secret in Secret Manager
   [path]                     Path of the secret to mount inside the job (either `path` or `env_var_name` must be set)
diff --git a/commands/commands.go b/commands/commands.go
@@ -33,7 +33,7 @@ import (
 	interlink "github.com/scaleway/scaleway-cli/v2/internal/namespaces/interlink/v1beta1"
 	"github.com/scaleway/scaleway-cli/v2/internal/namespaces/iot/v1"
 	"github.com/scaleway/scaleway-cli/v2/internal/namespaces/ipam/v1"
-	jobs "github.com/scaleway/scaleway-cli/v2/internal/namespaces/jobs/v1alpha1"
+	jobs "github.com/scaleway/scaleway-cli/v2/internal/namespaces/jobs/v1alpha2"
 	"github.com/scaleway/scaleway-cli/v2/internal/namespaces/k8s/v1"
 	keymanager "github.com/scaleway/scaleway-cli/v2/internal/namespaces/key_manager/v1alpha1"
 	"github.com/scaleway/scaleway-cli/v2/internal/namespaces/lb/v1"
diff --git a/docs/commands/jobs.md b/docs/commands/jobs.md
@@ -7,12 +7,12 @@ This API allows you to manage your Serverless Jobs.
   - [Delete an existing job definition by its unique identifier](#delete-an-existing-job-definition-by-its-unique-identifier)
   - [Get a job definition by its unique identifier](#get-a-job-definition-by-its-unique-identifier)
   - [List all your job definitions with filters](#list-all-your-job-definitions-with-filters)
-  - [Run an existing job definition by its unique identifier. This will create a new job run](#run-an-existing-job-definition-by-its-unique-identifier.-this-will-create-a-new-job-run)
+  - [Run an existing job definition using its unique identifier and create a new job run](#run-an-existing-job-definition-using-its-unique-identifier-and-create-a-new-job-run)
   - [Update an existing job definition associated with the specified unique identifier](#update-an-existing-job-definition-associated-with-the-specified-unique-identifier)
 - [](#)
   - [Get a job run by its unique identifier](#get-a-job-run-by-its-unique-identifier)
   - [List all job runs with filters](#list-all-job-runs-with-filters)
-  - [Stop a job run by its unique identifier](#stop-a-job-run-by-its-unique-identifier)
+  - [Stop a job run using its unique identifier](#stop-a-job-run-using-its-unique-identifier)
   - [Wait for a job run to reach a stable state](#wait-for-a-job-run-to-reach-a-stable-state)
 - [](#)
   - [Create a secret reference within a job definition](#create-a-secret-reference-within-a-job-definition)
@@ -43,11 +43,13 @@ scw jobs definition create [arg=value ...]
 | Name |   | Description |
 |------|---|-------------|
 | name | Required<br />Default: `<generated>` | Name of the job definition |
-| cpu-limit | Required | CPU limit of the job |
+| cpu-limit | Required | CPU limit of the job (in mvCPU) |
 | memory-limit | Required | Memory limit of the job (in MiB) |
 | local-storage-capacity |  | Local storage capacity of the job (in MiB) |
 | image-uri | Required | Image to use for the job |
-| command |  | Startup command. If empty or not defined, the image's default command is used. |
+| ~~command~~ | Deprecated | Startup command. If empty or not defined, the image's default command is used. |
+| startup-command.{index} |  | Job startup command. Overrides the default defined in the job image. |
+| args.{index} |  | Job arguments. Overrides the default arguments defined in the job image. |
 | project-id |  | Project ID to use. If none is passed the default project ID will be used |
 | environment-variables.{key} |  | Environment variables of the job |
 | description |  | Description of the job |
@@ -120,9 +122,9 @@ scw jobs definition list [arg=value ...]
 
 
 
-### Run an existing job definition by its unique identifier. This will create a new job run
+### Run an existing job definition using its unique identifier and create a new job run
 
-Run an existing job definition by its unique identifier. This will create a new job run.
+Run an existing job definition using its unique identifier and create a new job run.
 
 **Usage:**
 
@@ -136,7 +138,9 @@ scw jobs definition start <job-definition-id ...> [arg=value ...]
 | Name |   | Description |
 |------|---|-------------|
 | job-definition-id | Required | UUID of the job definition to start |
-| command |  | Contextual startup command for this specific job run |
+| ~~command~~ | Deprecated | Contextual startup command for this specific job run. |
+| startup-command.{index} |  | Contextual startup command for this specific job run. |
+| args.{index} |  | Contextual arguments for this specific job run. |
 | environment-variables.{key} |  | Contextual environment variables for this specific job run |
 | replicas |  | Number of jobs to run |
 | region | Default: `fr-par`<br />One of: `fr-par`, `nl-ams`, `pl-waw` | Region to target. If none is passed will use default region from the config |
@@ -160,11 +164,13 @@ scw jobs definition update <job-definition-id ...> [arg=value ...]
 |------|---|-------------|
 | job-definition-id | Required | UUID of the job definition to update |
 | name |  | Name of the job definition |
-| cpu-limit |  | CPU limit of the job |
+| cpu-limit |  | CPU limit of the job (in mvCPU) |
 | memory-limit |  | Memory limit of the job (in MiB) |
 | local-storage-capacity |  | Local storage capacity of the job (in MiB) |
 | image-uri |  | Image to use for the job |
-| command |  | Startup command |
+| ~~command~~ | Deprecated | Startup command. If empty or not defined, the image's default command is used. |
+| startup-command.{index} |  | Job startup command. Overrides the default defined in the job image. |
+| args.{index} |  | Job arguments. Overrides the default arguments defined in the job image. |
 | environment-variables.{key} |  | Environment variables of the job |
 | description |  | Description of the job |
 | job-timeout |  | Timeout of the job in seconds |
@@ -217,21 +223,22 @@ scw jobs run list [arg=value ...]
 | order-by | One of: `created_at_asc`, `created_at_desc` |  |
 | job-definition-id |  |  |
 | project-id |  |  |
-| state | One of: `unknown_state`, `queued`, `scheduled`, `running`, `succeeded`, `failed`, `canceled`, `internal_error` |  |
-| states.{index} | One of: `unknown_state`, `queued`, `scheduled`, `running`, `succeeded`, `failed`, `canceled`, `internal_error` |  |
+| state | One of: `unknown_state`, `initialized`, `validated`, `queued`, `running`, `succeeded`, `failed`, `interrupting`, `interrupted` |  |
+| states.{index} | One of: `unknown_state`, `initialized`, `validated`, `queued`, `running`, `succeeded`, `failed`, `interrupting`, `interrupted` |  |
+| reasons.{index} | One of: `unknown_reason`, `invalid_request`, `timeout`, `cancellation`, `technical_error`, `image_not_found`, `invalid_image`, `memory_usage_exceeded`, `storage_usage_exceeded`, `exited_with_error`, `secret_disabled`, `secret_not_found`, `quota_exceeded` |  |
 | organization-id |  |  |
 | region | Default: `fr-par`<br />One of: `fr-par`, `nl-ams`, `pl-waw`, `all` | Region to target. If none is passed will use default region from the config |
 
 
 
-### Stop a job run by its unique identifier
+### Stop a job run using its unique identifier
 
-Stop a job run by its unique identifier.
+Stop a job run using its unique identifier.
 
 **Usage:**
 
 ```
-scw jobs run stop <job-run-id ...> [arg=value ...]
+scw jobs run stop [arg=value ...]
 ```
 
 
@@ -308,7 +315,6 @@ scw jobs secret delete [arg=value ...]
 
 | Name |   | Description |
 |------|---|-------------|
-| job-definition-id | Required | UUID of the job definition |
 | secret-id | Required | UUID of the secret reference within the job |
 | region | Default: `fr-par`<br />One of: `fr-par`, `nl-ams`, `pl-waw` | Region to target. If none is passed will use default region from the config |
 
@@ -329,7 +335,6 @@ scw jobs secret get [arg=value ...]
 
 | Name |   | Description |
 |------|---|-------------|
-| job-definition-id | Required | UUID of the job definition |
 | secret-id | Required | UUID of the secret reference within the job |
 | region | Default: `fr-par`<br />One of: `fr-par`, `nl-ams`, `pl-waw` | Region to target. If none is passed will use default region from the config |
 
@@ -370,7 +375,6 @@ scw jobs secret update [arg=value ...]
 
 | Name |   | Description |
 |------|---|-------------|
-| job-definition-id | Required | UUID of the job definition |
 | secret-id | Required | UUID of the secret reference within the job |
 | secret-manager-version |  | Version of the secret in Secret Manager |
 | path |  | Path of the secret to mount inside the job (either `path` or `env_var_name` must be set) |
diff --git a/internal/namespaces/jobs/v1alpha1/jobs_cli.go b/internal/namespaces/jobs/v1alpha1/jobs_cli.go
diff --git a/internal/namespaces/jobs/v1alpha2/custom.go b/internal/namespaces/jobs/v1alpha2/custom.go
diff --git a/internal/namespaces/jobs/v1alpha2/custom_job_definition.go b/internal/namespaces/jobs/v1alpha2/custom_job_definition.go
diff --git a/internal/namespaces/jobs/v1alpha2/custom_job_run.go b/internal/namespaces/jobs/v1alpha2/custom_job_run.go
