-
Notifications
You must be signed in to change notification settings - Fork 34
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat(dashboard): add dashboard commands to cli reference (#413)
- Loading branch information
1 parent
5fc450e
commit 1def4ff
Showing
5 changed files
with
436 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| --- | ||
| title: "Dashboard" | ||
| linkTitle: "Dashboard" | ||
| description: > | ||
| Learn how to use CLI commands for the dashboard resource. | ||
| --- | ||
|
|
||
| The below commands are available to operate on the `dashboard` resource. | ||
|
|
||
| {{% alert color="warning" %}} | ||
| This section assumes you have already installed and setup the CLI. | ||
|
|
||
| To install the CLI, please review the [installation documentation](/docs/reference/cli/install/). | ||
|
|
||
| To setup the CLI, please review the [authentication documentation](/docs/reference/cli/authentication/). | ||
| {{% /alert %}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,100 @@ | ||
| --- | ||
| title: "Add" | ||
| linkTitle: "Add" | ||
| description: > | ||
| Learn how to create a dashboard. | ||
| --- | ||
|
|
||
| ## Command | ||
|
|
||
| ``` | ||
| $ vela add dashboard <parameters...> <arguments...> | ||
| ``` | ||
|
|
||
| {{% alert color="info" %}} | ||
| For more information, you can run `vela add dashboard --help`. | ||
| {{% /alert %}} | ||
|
|
||
| ## Parameters | ||
|
|
||
| The following parameters are used to configure the command: | ||
|
|
||
| | Name | Description | Environment Variables | | ||
| | ---------- | ------------------------------------------------- | ------------------------------------------------------- | | ||
| | `name` | name for the dashboard | `VELA_DASHBOARD_NAME`, `DASHBOARD_NAME` | | ||
| | `repos` | list of repositories (org/repo) for the dashboard | `VELA_DASHBOARD_REPOS`, `DASHBOARD_REPOS` | | ||
| | `branches` | filter builds in all repositories by branch | `VELA_DASHBOARD_REPOS_BRANCH`, `DASHBOARD_REPOS_BRANCH` | | ||
| | `events` | filter builds in all repositories by event | `VELA_DASHBOARD_REPOS_EVENT`, `DASHBOARD_REPOS_EVENT` | | ||
| | `admins` | provide the list of admins for the dashboard | `VELA_DASHBOARD_ADMINS`, `DASHBOARD_ADMINS` | | ||
| | `output` | format the output for the dashboard | `VELA_OUTPUT`, `REPO_OUTPUT` | | ||
|
|
||
| {{% alert color="info" %}} | ||
| This command also supports setting the following parameters via a configuration file: | ||
|
|
||
| - `output` | ||
|
|
||
| For more information, please review the [CLI config documentation](/docs/reference/cli/config/). | ||
| {{% /alert %}} | ||
|
|
||
| ## Sample | ||
|
|
||
| {{% alert color="warning" %}} | ||
| This section assumes you have already installed and setup the CLI. | ||
|
|
||
| To install the CLI, please review the [installation documentation](/docs/reference/cli/install/). | ||
|
|
||
| To setup the CLI, please review the [authentication documentation](/docs/reference/cli/authentication/). | ||
| {{% /alert %}} | ||
|
|
||
| #### Request | ||
|
|
||
| ```sh | ||
| $ vela add dashboard --name 'Octocat Main Branches' --repos octocat/Hello-World,octocat/Spoon-Knife --branches main | ||
| ``` | ||
|
|
||
| #### Response | ||
|
|
||
| ```sh | ||
| { | ||
| Name: Octocat Main Branches, | ||
| ID: d3040cd7-9bb6-45d1-a2a1-d794483a902c, | ||
| Admins: [{ | ||
| Active: true, | ||
| Admin: false, | ||
| Dashboards: [], | ||
| Favorites: [], | ||
| ID: 1, | ||
| Name: octokitty, | ||
| Token: , | ||
| }], | ||
| CreatedAt: 1716572402, | ||
| CreatedBy: octokitty, | ||
| UpdatedAt: 1716572402, | ||
| UpdatedBy: octokitty, | ||
| Repos: [{ | ||
| Name: octocat/Hello-World, | ||
| ID: 1, | ||
| Branches: [main], | ||
| Events: [], | ||
| } { | ||
| Name: octocat/Spoon-Knife, | ||
| ID: 2, | ||
| Branches: [main], | ||
| Events: [], | ||
| }], | ||
| } | ||
| ``` | ||
|
|
||
| ## Examples | ||
|
|
||
| ```sh | ||
| EXAMPLES: | ||
| 1. Add a dashboard. | ||
| $ vela add dashboard --name my-dashboard | ||
| 2. Add a dashboard with repositories. | ||
| $ vela add dashboard --name my-dashboard --repos Org-1/Repo-1,Org-2/Repo-2 | ||
| 3. Add a dashboard with repositories filtering builds by pushes to main. | ||
| $ vela add dashboard --name my-dashboard --repos Org-1/Repo-1,Org-2/Repo-2 --branch main --event push | ||
| 4. Add a dashboard with multiple admins. | ||
| $ vela add dashboard --name my-dashboard --admins JohnDoe,JaneDoe | ||
| ``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,119 @@ | ||
| --- | ||
| title: "Get" | ||
| linkTitle: "Get" | ||
| description: > | ||
| Learn how to list dashboards. | ||
| --- | ||
|
|
||
| ## Command | ||
|
|
||
| ``` | ||
| $ vela get dashboard <parameters...> <arguments...> | ||
| ``` | ||
|
|
||
| {{% alert color="info" %}} | ||
| For more information, you can run `vela get dashboard --help`. | ||
| {{% /alert %}} | ||
|
|
||
| ## Parameters | ||
|
|
||
| The following parameters are used to configure the command: | ||
|
|
||
| | Name | Description | Environment Variables | | ||
| | -------- | ------------------------------------------------------- | --------------------------------- | | ||
| | `full` | output the repo and build information for the dashboard | `VELA_FULL`, `DASHBOARD_FULL` | | ||
| | `output` | format the output for dashboards | `VELA_OUTPUT`, `DASHBOARD_OUTPUT` | | ||
|
|
||
| {{% alert color="info" %}} | ||
| This command also supports setting the following parameters via a configuration file: | ||
|
|
||
| - `output` | ||
|
|
||
| For more information, please review the [CLI config documentation](/docs/reference/cli/config/). | ||
| {{% /alert %}} | ||
|
|
||
| ## Sample | ||
|
|
||
| {{% alert color="warning" %}} | ||
| This section assumes you have already installed and setup the CLI. | ||
|
|
||
| To install the CLI, please review the [installation documentation](/docs/reference/cli/install/). | ||
|
|
||
| To setup the CLI, please review the [authentication documentation](/docs/reference/cli/authentication/). | ||
| {{% /alert %}} | ||
|
|
||
| #### Request | ||
|
|
||
| ```sh | ||
| $ vela get dashboard | ||
| ``` | ||
|
|
||
| #### Response | ||
|
|
||
| ```sh | ||
| [{ | ||
| Name: Octocat Main Branches, | ||
| ID: 59376e53-879f-478e-b6d2-b8aefe219c6d, | ||
| Admins: [{ | ||
| Active: true, | ||
| Admin: false, | ||
| Dashboards: [], | ||
| Favorites: [], | ||
| ID: 1, | ||
| Name: octokitty, | ||
| Token: , | ||
| }], | ||
| CreatedAt: 1715117480, | ||
| CreatedBy: octokitty, | ||
| UpdatedAt: 1715117480, | ||
| UpdatedBy: octokitty, | ||
| Repos: [{ | ||
| Name: octocat/Hello-World, | ||
| ID: 1, | ||
| Branches: [main], | ||
| Events: [], | ||
| } { | ||
| Name: octocat/Spoon-Knife, | ||
| ID: 2, | ||
| Branches: [main], | ||
| Events: [], | ||
| }], | ||
| } { | ||
| Name: Octocat PR Events, | ||
| ID: 0ebb9f01-389c-4a0f-b301-6bf2f9a0fe3b, | ||
| Admins: [{ | ||
| Active: true, | ||
| Admin: false, | ||
| Dashboards: [], | ||
| Favorites: [], | ||
| ID: 1, | ||
| Name: octokitty, | ||
| Token: , | ||
| }], | ||
| CreatedAt: 1716397739, | ||
| CreatedBy: octokitty, | ||
| UpdatedAt: 1716397739, | ||
| UpdatedBy: octokitty, | ||
| Repos: [{ | ||
| Name: octocat/Hello-World, | ||
| ID: 1, | ||
| Branches: [], | ||
| Events: [pull_request], | ||
| } { | ||
| Name: octocat/Spoon-Knife, | ||
| ID: 2, | ||
| Branches: [], | ||
| Events: [pull_request], | ||
| }], | ||
| }] | ||
| ``` | ||
|
|
||
| ## Examples | ||
|
|
||
| ```sh | ||
| EXAMPLES: | ||
| 1. Get user dashboards. | ||
| $ vela get dashboard | ||
| 2. Get user dashboards with repo and build information. | ||
| $ vela get dashboard --full | ||
| ``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,108 @@ | ||
| --- | ||
| title: "Update" | ||
| linkTitle: "Update" | ||
| description: > | ||
| Learn how to modify a dashboard. | ||
| --- | ||
|
|
||
| ## Command | ||
|
|
||
| ``` | ||
| $ vela update dashboard <parameters...> <arguments...> | ||
| ``` | ||
|
|
||
| {{% alert color="info" %}} | ||
| For more information, you can run `vela update dashboard --help`. | ||
| {{% /alert %}} | ||
|
|
||
| ## Parameters | ||
|
|
||
| The following parameters are used to configure the command: | ||
|
|
||
| | Name | Description | Environment Variables | | ||
| | -------------- | ------------------------------------------------------------ | ------------------------------------------------------- | | ||
| | `id` | uuid for the dashboard | `VELA_DASHBOARD_ID`, `DASHBOARD_ID` | | ||
| | `name` | name for the dashboard | `VELA_DASHBOARD_NAME`, `DASHBOARD_NAME` | | ||
| | `add-repos` | list of repositories to add for the dashboard | `VELA_DASHBOARD_ADD_REPOS`, `DASHBOARD_ADD_REPOS` | | ||
| | `drop-repos` | list of repositories to remove from the dashboard | `VELA_DASHBOARD_DROP_REPOS`, `DASHBOARD_DROP_REPOS` | | ||
| | `target-repos` | list of repositories to target for updates for the dashboard | `VELA_DASHBOARD_TARGET_REPOS`, `DASHBOARD_TARGET_REPOS` | | ||
| | `add-admins` | list of admins to add for the dashboard | `VELA_DASHBOARD_ADD_ADMINS`, `DASHBOARD_ADD_ADMINS` | | ||
| | `drop-admins` | list of admins to remove from the dashboard | `VELA_DASHBOARD_DROP_ADMINS`, `DASHBOARD_DROP_ADMINS` | | ||
| | `branches` | filter builds in all repositories by branch | `VELA_DASHBOARD_REPOS_BRANCH`, `DASHBOARD_REPOS_BRANCH` | | ||
| | `events` | filter builds in all repositories by event | `VELA_DASHBOARD_REPOS_EVENT`, `DASHBOARD_REPOS_EVENT` | | ||
| | `output` | format the output for the dashboard | `VELA_OUTPUT`, `DASHBOARD_OUTPUT` | | ||
|
|
||
| {{% alert color="info" %}} | ||
| This command also supports setting the following parameters via a configuration file: | ||
|
|
||
| - `output` | ||
|
|
||
| For more information, please review the [CLI config documentation](/docs/reference/cli/config/). | ||
| {{% /alert %}} | ||
|
|
||
| ## Sample | ||
|
|
||
| {{% alert color="warning" %}} | ||
| This section assumes you have already installed and setup the CLI. | ||
|
|
||
| To install the CLI, please review the [installation documentation](/docs/reference/cli/install/). | ||
|
|
||
| To setup the CLI, please review the [authentication documentation](/docs/reference/cli/authentication/). | ||
| {{% /alert %}} | ||
|
|
||
| #### Request | ||
|
|
||
| ```sh | ||
| $ vela update dashboard --id d3040cd7-9bb6-45d1-a2a1-d794483a902c --name 'Octocat Dev Branches' --target-repos octocat/Hello-world,octocat/Spoon-Knife --branches dev | ||
| ``` | ||
|
|
||
| #### Response | ||
|
|
||
| ```sh | ||
| { | ||
| Name: Octocat Dev Branches, | ||
| ID: d3040cd7-9bb6-45d1-a2a1-d794483a902c, | ||
| Admins: [{ | ||
| Active: true, | ||
| Admin: false, | ||
| Dashboards: [], | ||
| Favorites: [], | ||
| ID: 1, | ||
| Name: octokitty, | ||
| Token: , | ||
| }], | ||
| CreatedAt: 1716572402, | ||
| CreatedBy: octokitty, | ||
| UpdatedAt: 1716572402, | ||
| UpdatedBy: octokitty, | ||
| Repos: [{ | ||
| Name: octocat/Hello-World, | ||
| ID: 1, | ||
| Branches: [dev], | ||
| Events: [], | ||
| } { | ||
| Name: octocat/Spoon-Knife, | ||
| ID: 2, | ||
| Branches: [dev], | ||
| Events: [], | ||
| }], | ||
| } | ||
| ``` | ||
|
|
||
| ## Examples | ||
|
|
||
| ```sh | ||
| EXAMPLES: | ||
| 1. Update a dashboard to add a repository. | ||
| $ vela update dashboard --id c8da1302-07d6-11ea-882f-4893bca275b8 --add-repos Org-1/Repo-1 | ||
| 2. Update a dashboard to remove a repository. | ||
| $ vela update dashboard --id c8da1302-07d6-11ea-882f-4893bca275b8 --drop-repos Org-1/Repo-1 | ||
| 3. Update a dashboard to add event and branch filters to specific repositories. | ||
| $ vela update dashboard --id c8da1302-07d6-11ea-882f-4893bca275b8 --target-repos Org-1/Repo-1,Org-2/Repo-2 --branches main --events push | ||
| 4. Update a dashboard to change the name. | ||
| $ vela update dashboard --id c8da1302-07d6-11ea-882f-4893bca275b8 --name MyDashboard | ||
| 5. Update a dashboard to add an admin. | ||
| $ vela update dashboard --id c8da1302-07d6-11ea-882f-4893bca275b8 --add-admins JohnDoe | ||
| 6. Update a dashboard to remove an admin. | ||
| $ vela update dashboard --id c8da1302-07d6-11ea-882f-4893bca275b8 --drop-admins JohnDoe | ||
| ``` |
Oops, something went wrong.