diff --git a/Makefile b/Makefile index 4c7bffcb9f..bc6a1b5e61 100644 --- a/Makefile +++ b/Makefile @@ -15,9 +15,15 @@ initialize: ## Initialize the repository dependencies npm ci touch .env npx husky-init + vale sync + +clean: ## Clean common artifacts + npm run clear && npm run clean-api-docs + rm -rfv build -clean: ## Clean build artifacts +deep-clean: ## Clean all artifacts rm -rf node_modules build public .cache .docusaurus + npm run clear && npm run clean-api-docs docker image rm $(IMAGE) || echo "No image exists." clean-versions: ## Clean Docusarus content versions @@ -50,6 +56,12 @@ versions-ci: ## Create Docusarus content versions in a GitHub Actions CI environ @echo "creating versions" ./scripts/versions.sh $$RUNNER_TEMP + +api: ## Generate API docs + @echo "generating api docs" + npm run clear-api-docs + npm run generate-api-docs + ##@ Git Targets commit: ## Add a Git commit. Usage: make commit MESSAGE="" diff --git a/README.md b/README.md index 90e08f2b5d..59a7c860d2 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,8 @@ To contribute, we recommend having the following software installed locally on y - Node.js and npm (optional) +- [Vale](https://vale.sh/docs/vale-cli/installation/) + ## Local Development (Docker) To get started with the Docker based local development approach ensure you are in the root context of this repository. diff --git a/docs/docs-content/getting-started/dashboard.md b/docs/docs-content/getting-started/dashboard.md index 445a0325c0..d428926e2d 100644 --- a/docs/docs-content/getting-started/dashboard.md +++ b/docs/docs-content/getting-started/dashboard.md @@ -8,56 +8,59 @@ sidebar_position: 10 tags: ["getting-started"] --- -This section is a tour of the two main dashboards of the Tenant console–the **Project Dashboard** and the **Admin Dashboard**. The Project Dashboard is used to perform operations related to setting up your Kubernetes clusters such as setting up Cluster Profiles, Creating Cloud Accounts, and deploying clusters. The Admin Dashboard is used for performing administrative tasks such as setting up Single Sign On (SSO), creating user, teams and setting up Role-Based Access Control (RBAC), and setting up additional package registries. The Admin Dashboard is only available to the users who have the Tenant Admin role. Admin users can toggle between the Project Dashboard and Tenant Admin Dashboard. Users without the Tenant Admin role can only see the Project Dashboard. +This section is a tour of Palette's two main dashboards - the **Project** dashboard and the **Tenant Admin** dashboard. The **Project** dashboard is for non-admin users to perform operations related to setting up Kubernetes clusters, creating cluster profiles, creating cloud accounts, and deploying clusters. The **Tenant Admin** dashboard is used to perform administrative tasks such as setting up Single Sign On (SSO), creating users and teams, setting up Role-Based Access Control (RBAC), and setting up additional package registries. -## Project Dashboard - -Upon login, the dashboard shows the views available for a non-admin user. At the top, we have the Projects}> A Project helps to organize the cluster resources in a logical grouping method. button which helps to organize the cluster resources in a logical grouping. From the dropdown, we can shift between the projects. The left panel contains the Project Overview}>Project Overview gives an overview of the resource and cost consumption of the selected project. (2) which gives an overview of the resource and cost consumption of the selected project. Cluster Profiles}>Cluster Profiles are instantiated templates that are created with pre-configured layers/components needed for cluster deployments. (3) of the Default Project are shown. The left pane in this dashboard also contains options for clusters}>Kubernetes clusters in Palette that are instantiated from cluster profiles. (4). Workspaces}>Workspace Workspace enables the coupling of relevant namespaces across multiple clusters to manage access, obtain cost, and workload visibility by applications or teams. (5) enables the coupling of relevant namespaces across multiple clusters to manage access, obtain cost, and workload visibility by applications or teams. Audit logs}>Audit Logs gives the log of activities with timeline. (6) gives the log of activities with timeline. - - -#### Non-admin User view - -Upon login, the dashboard shows the views available for a non-admin user. +The **Tenant Admin** dashboard is only available to users who have the Tenant Admin role. Tenant admin users can toggle between the **Project** dashboard and **Tenant Admin** dashboard. Users without the tenant admin role can only view the **Project** dashboard. -1. The Projects}> A Project helps to organize the cluster resources in a logical grouping method. button which helps to organize the cluster resources in a logical grouping. From the dropdown, we can shift between the projects. - - -2. The left panel contains the Project Overview}>Project Overview gives an overview of the resource and cost consumption of the selected project. (2) which gives an overview of the resource and cost consumption of the selected project. +## Project Dashboard +The **Project** dashboard shows available views for non-admin users. Numbered items in the screenshot are described in the list below. -3. Cluster Profiles}>Cluster Profiles are instantiated templates that are created with pre-configured layers/components needed for cluster deployments. of the Default Project are shown. The left pane in this dashboard also contains options for clusters}>Kubernetes clusters in Palette that are instantiated from Cluster Profiles. + + +![A screenshot of the Project dashboard with numbered UI elements described in this document.](/getting-started_dashboard_project-dashboard.png) +1. Projects are used to organize the cluster resources within a logical group. Use the **drop-down Menu** to shift between projects. -4. Workspaces enables the coupling of relevant namespaces across multiple clusters to manage access, obtain cost, and workload visibility by applications or teams. +2. The [Project Overview](../projects.md) shows the resource and cost consumption of the selected project. +3. [Cluster profiles](../profiles/cluster-profiles/cluster-profiles.md) are instantiated templates that are created with pre-configured layers needed for cluster deployments. +4. Kubernetes [clusters](../clusters/clusters.md) in Palette are instantiated from cluster profiles. -5. Audit logs dusplay the log of activities with timeline. +5. [Cluster groups](../clusters/cluster-groups/cluster-groups.md) are a collection of one or more host clusters that together form a computing platform for users to deploy Palette Virtual Clusters. Downstream consumers can use the cluster group when using Palette in [App Mode](../introduction/palette-modes.md#what-is-app-mode). +6. [Workspaces](../workspace/workspace.md) enable the coupling of relevant namespaces across multiple clusters to manage access, obtain cost, and workload visibility by applications or teams. +7. [Audit logs](../audit-logs/audit-logs.md) display the log of activities within a certain time frame. -6. The **Settings** section (7) of the Default dashboard relates to the Cloud Account settings, Backup Location settings, and Alerts. This is an important distinction from the settings under the Admin Dashboard. It also allows the user to upload SSH keys for safekeeping. These key(s) can be recalled when deploying a cluster. +8. **Project Settings** allow users to configure settings for cloud accounts, backup locations, and alerts. It also allows users to upload SSH keys. Keys can be recalled when deploying a cluster. Platform settings are also available for controlling auto upgrades and auto remediation of unhealthy nodes in Palette-provisioned clusters. - ![project-dashboard](/project-dashboard.png) +## Tenant Admin Dashboard +The **Tenant Admin** dashboard shows available views for tenant administrators. Numbered items in the screenshot are described in the list below. -## Tenant Admin Dashboard + +![A screenshot of the Tenant Admin dashboard with numbered UI elements described in this document.](/getting-started_dashboard_admin-dashboard.png) +1. Tenant admins use the **drop-down Menu** to switch to the **Tenant Admin** dashboard. -The menu within the Tenant Admin Dashboard contains the Projects button. This is different from the Projects menu in the Default Dashboard. Within the Tenant Admin Dashboard, the Projects button provides access to modifying a project itself (edit/configure/delete and the overall status), whereas the button in the Default Dashboard provides access to the Cluster Profiles inside the project. +2. The **Tenant Admin** dashboard contains a **Projects** menu option, which the **Project** dashboard does not have. The **Projects** menu option allows tenant admins to create, modify, and delete projects. -1. The Cluster Profiles button in the Tenant Admin Dashboard provides the ability to create and manage Global Cluster profiles that can be used for cluster creation, across all projects, within a tenant. +3. The **Cluster Profiles** menu option allows tenant admins to create and manage global cluster profiles that can be used for cluster creation across all projects within a tenant. +4. Clusters created under the tenant admin scope are not visible under the project scope. -2. The Roles}>A Role is a collection of permissions. (and Permissions}>Permissions are associated with specific actions within the platform.); as well as Users}>Users are members of a tenant who are assigned roles that control their access within the platform. and Teams}>A Team is a group of users. Allows the admin to set or restrict these attributes for one or more team members. See the RBAC}>Palette's RBAC design allows granting granular access to resources and its operations. section for more details. +5. [Cluster groups](../clusters/cluster-groups/cluster-groups.md) are a collection of one or more host clusters that together form a computing platform for deploying virtual clusters. +6. Tenant admins can assign [Roles and Permissions](../user-management/user-management.md#rbac). -3. The audit logs(9)}>The Palette management platform application captures audit logs to track the user interaction with the application resources along with the timeline. in the admin Dashboard allow the admin to track the user interaction with the application resources along with the timeline for all projects and users. For admin users, the "audit log" button is visible for each project as well. Here, the admin can view the logs of the resources specific to the project. +7. Tenant admins can create [Users and Teams](../user-management/user-management.md#multi-organization-support-for-users). +8. [Audit logs](../audit-logs/audit-logs.md) in the **Tenant Admin** dashboard allow tracking user interaction with application resources for all projects and users. For admin users, the **Audit Log** button is visible for each project to view the logs of the resources specific to the project. -4. Finally, the Tenant Admin settings (10) under the Admin Dashboard provide access to the pack registries}>A pack is a collection of files such as manifests, Helm charts, ansible roles, configuration files, etc.; private cloud gateways}>A Private Cloud Gateway is a Palette component that enables the communication between Palette's management console and a VMware based private data center. and [SAML SSO](../user-management/saml-sso/saml-sso.md) configurations. +9. **Tenant Settings** give tenant admins access to the [pack registries](../registries-and-packs/registries-and-packs.md), [private cloud gateways](../glossary-all.md/#private-cloud-gateway), and [SAML and SSO](../user-management/saml-sso/saml-sso.md) setup. - ![admin-dashboard](/admin-dashboard.png) diff --git a/static/assets/docs/images/admin-dashboard.png b/static/assets/docs/images/admin-dashboard.png deleted file mode 100644 index cd1cb84f92..0000000000 Binary files a/static/assets/docs/images/admin-dashboard.png and /dev/null differ diff --git a/static/assets/docs/images/getting-started_dashboard_admin-dashboard.png b/static/assets/docs/images/getting-started_dashboard_admin-dashboard.png new file mode 100644 index 0000000000..2b09df2163 Binary files /dev/null and b/static/assets/docs/images/getting-started_dashboard_admin-dashboard.png differ diff --git a/static/assets/docs/images/getting-started_dashboard_project-dashboard.png b/static/assets/docs/images/getting-started_dashboard_project-dashboard.png new file mode 100644 index 0000000000..3d8ad3ff10 Binary files /dev/null and b/static/assets/docs/images/getting-started_dashboard_project-dashboard.png differ diff --git a/static/assets/docs/images/project-dashboard.png b/static/assets/docs/images/project-dashboard.png deleted file mode 100644 index 7658aad505..0000000000 Binary files a/static/assets/docs/images/project-dashboard.png and /dev/null differ