Onboard Argus Scrape Config: create command

docs/stackit_argus_scrape-configs.md

@@ -29,5 +29,6 @@ stackit argus scrape-configs [flags]
 ### SEE ALSO
 
 * [stackit argus](./stackit_argus.md)	 - Provides functionality for Argus
+* [stackit argus scrape-configs create](./stackit_argus_scrape-configs_create.md)	 - Creates a Scrape Config job for an Argus instance
 * [stackit argus scrape-configs generate-payload](./stackit_argus_scrape-configs_generate-payload.md)	 - Generates a payload to create/update Scrape Configurations for an Argus instance 
 

docs/stackit_argus_scrape-configs_create.md

@@ -0,0 +1,55 @@
+## stackit argus scrape-configs create
+
+Creates a Scrape Config job for an Argus instance
+
+### Synopsis
+
+Creates a Scrape Config job for an Argus instance.
+The payload can be provided as a JSON string or a file path prefixed with "@".
+If no payload is provided, a default payload will be used.
+See https://docs.api.stackit.cloud/documentation/argus/version/v1#tag/scrape-config/operation/v1_projects_instances_scrapeconfigs_create for information regarding the payload structure.
+
+```
+stackit argus scrape-configs create [flags]
+```
+
+### Examples
+
+```
+  Create a Scrape Config job on Argus instance "xxx" using default configuration
+  $ stackit argus scrape-configs create
+
+  Create a Scrape Config job on Argus instance "xxx" using an API payload sourced from the file "./payload.json"
+  $ stackit argus scrape-configs create --payload @./payload.json --instance-id xxx
+
+  Create a Scrape Config job on Argus instance "xxx" using an API payload provided as a JSON string
+  $ stackit argus scrape-configs create --payload "{...}" --instance-id xxx
+
+  Generate a payload with default values, and adapt it with custom values for the different configuration options
+  $ stackit argus scrape-configs generate-payload > ./payload.json
+  <Modify payload in file, if needed>
+  $ stackit argus scrape-configs create --payload @./payload.json --instance-id xxx
+```
+
+### Options
+
+```
+  -h, --help                 Help for "stackit argus scrape-configs create"
+      --instance-id string   Instance ID
+      --payload string       Request payload (JSON). Can be a string or a file path, if prefixed with "@" (example: @./payload.json). If unset, will use a default payload (you can check it by running "stackit argus scrape-configs generate-payload")
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit argus scrape-configs](./stackit_argus_scrape-configs.md)	 - Provides functionality for scrape configs in Argus.
+

docs/stackit_argus_scrape-configs_generate-payload.md

@@ -8,7 +8,7 @@ Generates a JSON payload with values to be used as --payload input for Scrape Co
 This command can be used to generate a payload to update an existing Scrape Config job or to create a new Scrape Config job.
 To update an existing Scrape Config job, provide the job name and the instance ID of the Argus instance.
 To obtain a default payload to create a new Scrape Config job, run the command with no flags.
-Note that the default values provided, particularly for the job name, the metrics path and URL of the targets, should be changed to your use case.
+Note that some of the default values provided, such as the job name, the metrics path and URL of the targets, should be adapted to your use case.
 See https://docs.api.stackit.cloud/documentation/argus/version/v1#tag/scrape-config/operation/v1_projects_instances_scrapeconfigs_create for information regarding the payload structure.
 
 

internal/cmd/argus/scrape-configs/create/create.go

@@ -0,0 +1,164 @@
+package create
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+
+	"github.com/stackitcloud/stackit-cli/internal/pkg/args"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/errors"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/examples"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/flags"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/globalflags"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/print"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/services/argus/client"
+	argusUtils "github.com/stackitcloud/stackit-cli/internal/pkg/services/argus/utils"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/spinner"
+
+	"github.com/spf13/cobra"
+	"github.com/stackitcloud/stackit-sdk-go/services/argus"
+	"github.com/stackitcloud/stackit-sdk-go/services/argus/wait"
+)
+
+const (
+	payloadFlag    = "payload"
+	instanceIdFlag = "instance-id"
+)
+
+type inputModel struct {
+	*globalflags.GlobalFlagModel
+	InstanceId string
+	Payload    *argus.CreateScrapeConfigPayload
+}
+
+func NewCmd(p *print.Printer) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "create",
+		Short: "Creates a Scrape Config job for an Argus instance",
+		Long: fmt.Sprintf("%s\n%s\n%s\n%s",
+			"Creates a Scrape Config job for an Argus instance.",
+			"The payload can be provided as a JSON string or a file path prefixed with \"@\".",
+			"If no payload is provided, a default payload will be used.",
+			"See https://docs.api.stackit.cloud/documentation/argus/version/v1#tag/scrape-config/operation/v1_projects_instances_scrapeconfigs_create for information regarding the payload structure.",
+		),
+		Args: args.NoArgs,
+		Example: examples.Build(
+			examples.NewExample(
+				`Create a Scrape Config job on Argus instance "xxx" using default configuration`,
+				"$ stackit argus scrape-configs create"),
+			examples.NewExample(
+				`Create a Scrape Config job on Argus instance "xxx" using an API payload sourced from the file "./payload.json"`,
+				"$ stackit argus scrape-configs create --payload @./payload.json --instance-id xxx"),
+			examples.NewExample(
+				`Create a Scrape Config job on Argus instance "xxx" using an API payload provided as a JSON string`,
+				`$ stackit argus scrape-configs create --payload "{...}" --instance-id xxx`),
+			examples.NewExample(
+				`Generate a payload with default values, and adapt it with custom values for the different configuration options`,
+				`$ stackit argus scrape-configs generate-payload > ./payload.json`,
+				`<Modify payload in file, if needed>`,
+				`$ stackit argus scrape-configs create --payload @./payload.json --instance-id xxx`),
+		),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			ctx := context.Background()
+			model, err := parseInput(cmd)
+			if err != nil {
+				return err
+			}
+
+			// Configure API client
+			apiClient, err := client.ConfigureClient(p)
+			if err != nil {
+				return err
+			}
+
+			instanceLabel, err := argusUtils.GetInstanceName(ctx, apiClient, model.InstanceId, model.ProjectId)
+			if err != nil {
+				instanceLabel = model.InstanceId
+			}
+
+			if !model.AssumeYes {
+				prompt := fmt.Sprintf("Are you sure you want to create a Scrape Config job on Argus instance %q?", instanceLabel)
+				err = p.PromptForConfirmation(prompt)
+				if err != nil {
+					return err
+				}
+			}
+
+			// Fill in default payload, if needed
+			if model.Payload == nil {
+				defaultPayload := argusUtils.DefaultCreateScrapeConfigPayload
+				if err != nil {
+					return fmt.Errorf("get default payload: %w", err)
+				}
+				model.Payload = &defaultPayload
+			}
+
+			// Call API
+			req := buildRequest(ctx, model, apiClient)
+			_, err = req.Execute()
+			if err != nil {
+				return fmt.Errorf("create Scrape Config job: %w", err)
+			}
+
+			jobName := model.Payload.JobName
+
+			// Wait for async operation, if async mode not enabled
+			if !model.Async {
+				s := spinner.New(p)
+				s.Start("Creating scrape config")
+				_, err = wait.CreateScrapeConfigWaitHandler(ctx, apiClient, model.InstanceId, *jobName, model.ProjectId).WaitWithContext(ctx)
+				if err != nil {
+					return fmt.Errorf("wait for Scrape Config job creation: %w", err)
+				}
+				s.Stop()
+			}
+
+			operationState := "Created"
+			if model.Async {
+				operationState = "Triggered creation of"
+			}
+			p.Outputf("%s Scrape Config job with name %q for Argus instance %q\n", operationState, *jobName, instanceLabel)
+			return nil
+		},
+	}
+	configureFlags(cmd)
+	return cmd
+}
+
+func configureFlags(cmd *cobra.Command) {
+	cmd.Flags().Var(flags.ReadFromFileFlag(), payloadFlag, `Request payload (JSON). Can be a string or a file path, if prefixed with "@" (example: @./payload.json). If unset, will use a default payload (you can check it by running "stackit argus scrape-configs generate-payload")`)
+	cmd.Flags().Var(flags.UUIDFlag(), instanceIdFlag, "Instance ID")
+
+	err := flags.MarkFlagsRequired(cmd, instanceIdFlag)
+	cobra.CheckErr(err)
+}
+
+func parseInput(cmd *cobra.Command) (*inputModel, error) {
+	globalFlags := globalflags.Parse(cmd)
+	if globalFlags.ProjectId == "" {
+		return nil, &errors.ProjectIdError{}
+	}
+
+	payloadValue := flags.FlagToStringPointer(cmd, payloadFlag)
+	var payload *argus.CreateScrapeConfigPayload
+	if payloadValue != nil {
+		payload = &argus.CreateScrapeConfigPayload{}
+		err := json.Unmarshal([]byte(*payloadValue), payload)
+		if err != nil {
+			return nil, fmt.Errorf("encode payload: %w", err)
+		}
+	}
+
+	return &inputModel{
+		GlobalFlagModel: globalFlags,
+		Payload:         payload,
+		InstanceId:      flags.FlagToStringValue(cmd, instanceIdFlag),
+	}, nil
+}
+
+func buildRequest(ctx context.Context, model *inputModel, apiClient *argus.APIClient) argus.ApiCreateScrapeConfigRequest {
+	req := apiClient.CreateScrapeConfig(ctx, model.InstanceId, model.ProjectId)
+
+	req = req.CreateScrapeConfigPayload(*model.Payload)
+	return req
+}