Merge main (#241)

* Add `argus grafana describe` command (#221)

* Add `argus grafana config describe` command

* Extend command to also show dashboard URL

* Generate docs

* Improve command descriptions

* Adjust function names

* Show initial Grafana credentials in output

* Add example for showing password

* Change to hide-password flag

* Update GitHub actions (#223)

* Implemnt util for Argus grafana configuration commands (#224)

* Add `argus grafana single-sign-on` commands (#228)

* Add argus grafana single-sign-on enable command

* Add argus grafana single-sign-on disable command

* Update docs

* Register disable command and update docs

* Improvements after review

* Add repology packaging status badge to INSTALLATION docs (#215)

* Add argus grafana `public-read-access` commands (#229)

* Copy files from single sign-on

* Adaptations for the public-read-access commands

* Update docs

* Improvements after review

* Move instance ID to argument

* Adapt examples

* Change config handling: only create config file & directory if needed (#214)

* Change config handling: only create config file & directory if needed

* Changes from code review

* Fix config read

* correctly handle f.Close error

* chore(deps): update renovatebot/github-action action to v40.1.9 (#225)

Co-authored-by: Renovate Bot <[email protected]>

* fix(deps): update module github.com/stackitcloud/stackit-sdk-go/services/ske to v0.13.0 (#226)

Co-authored-by: Renovate Bot <[email protected]>

* Improvements for argus grafana commands (#230)

* Add debug error logs (#217)

* add error debug logs to clients

* add error debug logs to refreshToken

* add error debug logs to label fetching

* Update internal/pkg/services/argus/client/client.go

Co-authored-by: Vicente Pinto <[email protected]>

* Update internal/pkg/services/argus/client/client.go

Co-authored-by: Vicente Pinto <[email protected]>

* add error debug logs to flag conversions

* add printer to argus grafana commands

* add debug log to getBearerToken function

* fix debug messages on clients

* Update internal/pkg/flags/flag_to_value.go

Co-authored-by: Vicente Pinto <[email protected]>

* remove obsolete err from the debug messages

* make printer first parameter

* add printer to new argus commands

* Update internal/pkg/auth/user_token_flow.go

Co-authored-by: Vicente Pinto <[email protected]>

* Update internal/cmd/root.go

Co-authored-by: Vicente Pinto <[email protected]>

* fix linting problem

* add string formatting to the printer debug function

* set source in log handler to false

---------

Co-authored-by: Vicente Pinto <[email protected]>

* change order of debug and error logs (#232)

* Output format none (#234)

* Output format none

* Add unit test, move const to print pkg

* Switch usage of const

* Signature (#237)

* update docs for output format none addition (#239)

* merge main

* add error level debug logs to scrape config commands

---------

Co-authored-by: João Palet <[email protected]>
Co-authored-by: GokceGK <[email protected]>
Co-authored-by: Kumm-Kai <[email protected]>
Co-authored-by: stackit-pipeline <[email protected]>
Co-authored-by: Renovate Bot <[email protected]>
Co-authored-by: Vicente Pinto <[email protected]>

Author: 7 people

.github/workflows/renovate.yaml

@@ -13,7 +13,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Self-hosted Renovate
-        uses: renovatebot/[email protected].0
+        uses: renovatebot/[email protected].9
         with:
           configurationFile: .github/renovate.json
           token: ${{ secrets.RENOVATE_TOKEN }}

INSTALLATION.md

@@ -2,6 +2,8 @@
 
 ## Package managers
 
+[![Packaging status](https://repology.org/badge/vertical-allrepos/stackit-cli.svg?columns=3)](https://repology.org/project/stackit-cli/versions)
+
 ### macOS
 
 The STACKIT CLI can be installed through the [Homebrew](https://brew.sh/) package manager.

docs/stackit.md

@@ -18,7 +18,7 @@ stackit [flags]
   -y, --assume-yes             If set, skips all confirmation prompts
       --async                  If set, runs the command asynchronously
   -h, --help                   Help for "stackit"
-  -o, --output-format string   Output format, one of ["json" "pretty"]
+  -o, --output-format string   Output format, one of ["json" "pretty" "none"]
   -p, --project-id string      Project ID
       --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
   -v, --version                Show "stackit" version

docs/stackit_argus.md

@@ -21,14 +21,15 @@ stackit argus [flags]
 ```
   -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"]
+  -o, --output-format string   Output format, one of ["json" "pretty" "none"]
   -p, --project-id string      Project ID
       --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
 ```
 
 ### SEE ALSO
 
 * [stackit](./stackit.md)	 - Manage STACKIT resources using the command line
+* [stackit argus grafana](./stackit_argus_grafana.md)	 - Provides functionality for the Grafana configuration of Argus instances
 * [stackit argus instance](./stackit_argus_instance.md)	 - Provides functionality for Argus instances
 * [stackit argus plans](./stackit_argus_plans.md)	 - Lists all Argus service plans
 * [stackit argus scrape-config](./stackit_argus_scrape-config.md)	 - Provides functionality for scrape configurations in Argus

docs/stackit_argus_grafana.md

@@ -0,0 +1,35 @@
+## stackit argus grafana
+
+Provides functionality for the Grafana configuration of Argus instances
+
+### Synopsis
+
+Provides functionality for the Grafana configuration of Argus instances.
+
+```
+stackit argus grafana [flags]
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus grafana"
+```
+
+### 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" "none"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit argus](./stackit_argus.md)	 - Provides functionality for Argus
+* [stackit argus grafana describe](./stackit_argus_grafana_describe.md)	 - Shows details of the Grafana configuration of an Argus instance
+* [stackit argus grafana public-read-access](./stackit_argus_grafana_public-read-access.md)	 - Enable or disable public read access for Grafana in Argus instances
+* [stackit argus grafana single-sign-on](./stackit_argus_grafana_single-sign-on.md)	 - Enable or disable single sign-on for Grafana in Argus instances
+

docs/stackit_argus_grafana_describe.md

@@ -0,0 +1,48 @@
+## stackit argus grafana describe
+
+Shows details of the Grafana configuration of an Argus instance
+
+### Synopsis
+
+Shows details of the Grafana configuration of an Argus instance.
+The Grafana dashboard URL and initial credentials (admin user and password) will be shown in the "pretty" output format. These credentials are only valid for first login. Please change the password after first login. After changing, the initial password is no longer valid.
+The initial password is shown by default, if you want to hide it use the "--hide-password" flag.
+
+```
+stackit argus grafana describe INSTANCE_ID [flags]
+```
+
+### Examples
+
+```
+  Get details of the Grafana configuration of an Argus instance with ID "xxx"
+  $ stackit argus credentials describe xxx
+
+  Get details of the Grafana configuration of an Argus instance with ID "xxx" in a table format
+  $ stackit argus credentials describe xxx --output-format pretty
+
+  Get details of the Grafana configuration of an Argus instance with ID "xxx" and hide the initial admin password
+  $ stackit argus credentials describe xxx --output-format pretty --hide-password
+```
+
+### Options
+
+```
+  -h, --help            Help for "stackit argus grafana describe"
+      --hide-password   Show the initial admin password in the "pretty" output format
+```
+
+### 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" "none"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit argus grafana](./stackit_argus_grafana.md)	 - Provides functionality for the Grafana configuration of Argus instances
+

docs/stackit_argus_grafana_public-read-access.md

@@ -0,0 +1,35 @@
+## stackit argus grafana public-read-access
+
+Enable or disable public read access for Grafana in Argus instances
+
+### Synopsis
+
+Enable or disable public read access for Grafana in Argus instances.
+When enabled, anyone can access the Grafana dashboards of the instance without logging in. Otherwise, a login is required.
+
+```
+stackit argus grafana public-read-access [flags]
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus grafana public-read-access"
+```
+
+### 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" "none"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit argus grafana](./stackit_argus_grafana.md)	 - Provides functionality for the Grafana configuration of Argus instances
+* [stackit argus grafana public-read-access disable](./stackit_argus_grafana_public-read-access_disable.md)	 - Disables public read access for Grafana on Argus instances
+* [stackit argus grafana public-read-access enable](./stackit_argus_grafana_public-read-access_enable.md)	 - Enables public read access for Grafana on Argus instances
+

docs/stackit_argus_grafana_public-read-access_disable.md

@@ -0,0 +1,40 @@
+## stackit argus grafana public-read-access disable
+
+Disables public read access for Grafana on Argus instances
+
+### Synopsis
+
+Disables public read access for Grafana on Argus instances.
+When disabled, a login is required to access the Grafana dashboards of the instance. Otherwise, anyone can access the dashboards.
+
+```
+stackit argus grafana public-read-access disable INSTANCE_ID [flags]
+```
+
+### Examples
+
+```
+  Disable public read access for Grafana on an Argus instance with ID "xxx"
+  $ stackit argus grafana public-read-access disable xxx
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus grafana public-read-access disable"
+```
+
+### 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" "none"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit argus grafana public-read-access](./stackit_argus_grafana_public-read-access.md)	 - Enable or disable public read access for Grafana in Argus instances
+

docs/stackit_argus_grafana_public-read-access_enable.md

@@ -0,0 +1,40 @@
+## stackit argus grafana public-read-access enable
+
+Enables public read access for Grafana on Argus instances
+
+### Synopsis
+
+Enables public read access for Grafana on Argus instances.
+When enabled, anyone can access the Grafana dashboards of the instance without logging in. Otherwise, a login is required.
+
+```
+stackit argus grafana public-read-access enable INSTANCE_ID [flags]
+```
+
+### Examples
+
+```
+  Enable public read access for Grafana on an Argus instance with ID "xxx"
+  $ stackit argus grafana public-read-access enable xxx
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus grafana public-read-access enable"
+```
+
+### 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" "none"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit argus grafana public-read-access](./stackit_argus_grafana_public-read-access.md)	 - Enable or disable public read access for Grafana in Argus instances
+

docs/stackit_argus_grafana_single-sign-on.md

@@ -0,0 +1,35 @@
+## stackit argus grafana single-sign-on
+
+Enable or disable single sign-on for Grafana in Argus instances
+
+### Synopsis
+
+Enable or disable single sign-on for Grafana in Argus instances.
+When enabled for an instance, overwrites the generic OAuth2 authentication and configures STACKIT single sign-on for that instance.
+
+```
+stackit argus grafana single-sign-on [flags]
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus grafana single-sign-on"
+```
+
+### 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" "none"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit argus grafana](./stackit_argus_grafana.md)	 - Provides functionality for the Grafana configuration of Argus instances
+* [stackit argus grafana single-sign-on disable](./stackit_argus_grafana_single-sign-on_disable.md)	 - Disables single sign-on for Grafana on Argus instances
+* [stackit argus grafana single-sign-on enable](./stackit_argus_grafana_single-sign-on_enable.md)	 - Enables single sign-on for Grafana on Argus instances
+

docs/stackit_argus_grafana_single-sign-on_disable.md

@@ -0,0 +1,40 @@
+## stackit argus grafana single-sign-on disable
+
+Disables single sign-on for Grafana on Argus instances
+
+### Synopsis
+
+Disables single sign-on for Grafana on Argus instances.
+When disabled for an instance, the generic OAuth2 authentication is used for that instance.
+
+```
+stackit argus grafana single-sign-on disable INSTANCE_ID [flags]
+```
+
+### Examples
+
+```
+  Disable single sign-on for Grafana on an Argus instance with ID "xxx"
+  $ stackit argus grafana single-sign-on disable xxx
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus grafana single-sign-on disable"
+```
+
+### 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" "none"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit argus grafana single-sign-on](./stackit_argus_grafana_single-sign-on.md)	 - Enable or disable single sign-on for Grafana in Argus instances
+

docs/stackit_argus_grafana_single-sign-on_enable.md

@@ -0,0 +1,40 @@
+## stackit argus grafana single-sign-on enable
+
+Enables single sign-on for Grafana on Argus instances
+
+### Synopsis
+
+Enables single sign-on for Grafana on Argus instances.
+When enabled for an instance, overwrites the generic OAuth2 authentication and configures STACKIT single sign-on for that instance.
+
+```
+stackit argus grafana single-sign-on enable INSTANCE_ID [flags]
+```
+
+### Examples
+
+```
+  Enable single sign-on for Grafana on an Argus instance with ID "xxx"
+  $ stackit argus grafana single-sign-on enable xxx
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus grafana single-sign-on enable"
+```
+
+### 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" "none"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit argus grafana single-sign-on](./stackit_argus_grafana_single-sign-on.md)	 - Enable or disable single sign-on for Grafana in Argus instances
+

docs/stackit_argus_instance.md

@@ -21,7 +21,7 @@ stackit argus instance [flags]
 ```
   -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"]
+  -o, --output-format string   Output format, one of ["json" "pretty" "none"]
   -p, --project-id string      Project ID
       --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
 ```

docs/stackit_argus_instance_create.md

@@ -34,7 +34,7 @@ stackit argus instance create [flags]
 ```
   -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"]
+  -o, --output-format string   Output format, one of ["json" "pretty" "none"]
   -p, --project-id string      Project ID
       --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
 ```

docs/stackit_argus_instance_delete.md

@@ -28,7 +28,7 @@ stackit argus instance delete INSTANCE_ID [flags]
 ```
   -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"]
+  -o, --output-format string   Output format, one of ["json" "pretty" "none"]
   -p, --project-id string      Project ID
       --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
 ```