diff --git a/calico-cloud/get-started/install-cluster.mdx b/calico-cloud/get-started/install-cluster.mdx index 810273c340..496f8ead96 100644 --- a/calico-cloud/get-started/install-cluster.mdx +++ b/calico-cloud/get-started/install-cluster.mdx @@ -17,6 +17,7 @@ You can quickly connect a cluster to Calico Cloud by generating a unique kubectl ## Connect a cluster to Calico Cloud with kubectl +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. From the **Managed Clusters** page, click **Connect Cluster**. 1. In the **Connect a Cluster** dialog, enter a **Cluster Name** and select a **Cluster Type**. 1. Optional: If you must install a specific older release, select the Calico Cloud version you want to install. @@ -45,6 +46,7 @@ You can quickly connect a cluster to Calico Cloud by generating a unique kubectl ## Connect a cluster to Calico Cloud with Helm +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. From the **Managed Clusters** page, click **Connect Cluster**. 1. In the **Connect a Cluster** dialog, enter a **Cluster Name** and select a **Cluster Type**. 1. Optional: If you must install a specific older release, select the Calico Cloud version you want to install. diff --git a/calico-cloud/get-started/install-private-registry.mdx b/calico-cloud/get-started/install-private-registry.mdx index 9226a8dbac..c9b0e12721 100644 --- a/calico-cloud/get-started/install-private-registry.mdx +++ b/calico-cloud/get-started/install-private-registry.mdx @@ -26,6 +26,7 @@ You can perform a Helm installation from images stored on a private registry. ## Install Calico Cloud using a private registry +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. From the **Managed Clusters** page, click **Connect Cluster**. 1. In the **Connect a Cluster** dialog, enter a **Cluster Name** and select a **Cluster Type**. 1. Optional: If you must install a specific older release, select the Calico Cloud version you want to install. We always recommend the latest version, which is installed by default. diff --git a/calico-cloud/get-started/setup-private-registry.mdx b/calico-cloud/get-started/setup-private-registry.mdx index d3e093def8..2c675ee272 100644 --- a/calico-cloud/get-started/setup-private-registry.mdx +++ b/calico-cloud/get-started/setup-private-registry.mdx @@ -42,6 +42,7 @@ Add the required $[prodname] images to a private registry. ### Set up registry credentials 1. Log into $[prodname] and navigate to "Managed Clusters". +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. Get the "Registry Credentials" by clicking on the icon. ![registry credentials](/img/calico-cloud/private-registry-icon.png) 1. Apply the credentials so the $[prodname] images can be accessed. diff --git a/calico-cloud/get-started/upgrade-cluster.mdx b/calico-cloud/get-started/upgrade-cluster.mdx index 0b697cfc53..3085316087 100644 --- a/calico-cloud/get-started/upgrade-cluster.mdx +++ b/calico-cloud/get-started/upgrade-cluster.mdx @@ -4,9 +4,10 @@ description: Steps to upgrade to the latest version of Calico Cloud. # Upgrade Calico Cloud -To upgrade managed clusters to the latest version of $[prodname]: +To upgrade a managed cluster to the latest version of $[prodname]: -1. From the web console, go to **Managed Clusters**. +1. From the web console, go to the **Managed Clusters** page. +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. For the cluster you want to upgrade, select **Actions** > **Reinstall**. 1. In the **Reinstall Cluster** dialog, select a newer version of $[prodname] from the list, click **Reinstall**, and copy the generated kubectl command.
diff --git a/calico-cloud/tutorials/calico-cloud-features/projects.mdx b/calico-cloud/tutorials/calico-cloud-features/projects.mdx new file mode 100644 index 0000000000..da65482095 --- /dev/null +++ b/calico-cloud/tutorials/calico-cloud-features/projects.mdx @@ -0,0 +1,59 @@ +--- +description: About projects +--- + +import Screenshot from '/src/___new___/components/Screenshot'; + + +# Projects + +You can use projects to organize your managed clusters into logical groupings. + + + +## About projects + +In $[prodname], a *project* is a logical grouping of one or more managed clusters. +You can use projects to organize your managed clusters in ways that are useful for your organization. +For example, you can use projects to segregate clusters by product teams, or by geo location. + +When you view observability tools in Calico Cloud, you see only what is available for the current project. + +All Calico Cloud organizations start with a single default project. +You can have up to three projects at a given time. + +## Create a project + +**Prerequisites** + +* You have Admin or Owner privileges. + +**Procedure** + +1. From any page in the web console, click the **Project** menu and then click **Manage Projects**. +1. On the **Projects** page, click **Add Project**. +1. Enter a name and description for the project, and then click the **Add Project** button. + + Provisioning the new project takes a few minutes. + When provisioning is complete, you can begin connecting clusters. + +## Connect a cluster to a project + +* To connect a cluster to a specific project, make sure you have selected the project you want as you follow the procedure to [connect your cluster to Calico Cloud](../../get-started/install-cluster.mdx). + +## Move a managed cluster to another project + +You can move a managed cluster to another project by removing it from the original project and connecting it to the new project. + +:::warning +Log data held by Calico Cloud will be deleted when you remove your cluster from the original project. +When you reconnect your cluster to Calico Cloud as part of the new project, flow logs will start to be collected again. +You will not be able to restore access to the old logs. + +If you need to retain logs, contact [our support team](https://tigeraio.my.site.com/community/s/login/). +::: + +1. To remove your cluster from Calico Cloud, find your cluster on the **Managed Clusters** page, and then click **Actions > Delete**. + After a moment, the cluster is removed from the list. +1. Move to the new project by clicking the **Projects** menu and selecting your project. +1. To reconnect your cluster, follow the guide to [connect your cluster to Calico Cloud](../../get-started/install-cluster.mdx). diff --git a/calico-cloud_versioned_docs/version-22-2/get-started/install-cluster.mdx b/calico-cloud_versioned_docs/version-22-2/get-started/install-cluster.mdx index 810273c340..496f8ead96 100644 --- a/calico-cloud_versioned_docs/version-22-2/get-started/install-cluster.mdx +++ b/calico-cloud_versioned_docs/version-22-2/get-started/install-cluster.mdx @@ -17,6 +17,7 @@ You can quickly connect a cluster to Calico Cloud by generating a unique kubectl ## Connect a cluster to Calico Cloud with kubectl +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. From the **Managed Clusters** page, click **Connect Cluster**. 1. In the **Connect a Cluster** dialog, enter a **Cluster Name** and select a **Cluster Type**. 1. Optional: If you must install a specific older release, select the Calico Cloud version you want to install. @@ -45,6 +46,7 @@ You can quickly connect a cluster to Calico Cloud by generating a unique kubectl ## Connect a cluster to Calico Cloud with Helm +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. From the **Managed Clusters** page, click **Connect Cluster**. 1. In the **Connect a Cluster** dialog, enter a **Cluster Name** and select a **Cluster Type**. 1. Optional: If you must install a specific older release, select the Calico Cloud version you want to install. diff --git a/calico-cloud_versioned_docs/version-22-2/get-started/install-private-registry.mdx b/calico-cloud_versioned_docs/version-22-2/get-started/install-private-registry.mdx index 9226a8dbac..c9b0e12721 100644 --- a/calico-cloud_versioned_docs/version-22-2/get-started/install-private-registry.mdx +++ b/calico-cloud_versioned_docs/version-22-2/get-started/install-private-registry.mdx @@ -26,6 +26,7 @@ You can perform a Helm installation from images stored on a private registry. ## Install Calico Cloud using a private registry +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. From the **Managed Clusters** page, click **Connect Cluster**. 1. In the **Connect a Cluster** dialog, enter a **Cluster Name** and select a **Cluster Type**. 1. Optional: If you must install a specific older release, select the Calico Cloud version you want to install. We always recommend the latest version, which is installed by default. diff --git a/calico-cloud_versioned_docs/version-22-2/get-started/setup-private-registry.mdx b/calico-cloud_versioned_docs/version-22-2/get-started/setup-private-registry.mdx index d3e093def8..2c675ee272 100644 --- a/calico-cloud_versioned_docs/version-22-2/get-started/setup-private-registry.mdx +++ b/calico-cloud_versioned_docs/version-22-2/get-started/setup-private-registry.mdx @@ -42,6 +42,7 @@ Add the required $[prodname] images to a private registry. ### Set up registry credentials 1. Log into $[prodname] and navigate to "Managed Clusters". +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. Get the "Registry Credentials" by clicking on the icon. ![registry credentials](/img/calico-cloud/private-registry-icon.png) 1. Apply the credentials so the $[prodname] images can be accessed. diff --git a/calico-cloud_versioned_docs/version-22-2/get-started/upgrade-cluster.mdx b/calico-cloud_versioned_docs/version-22-2/get-started/upgrade-cluster.mdx index 0b697cfc53..3085316087 100644 --- a/calico-cloud_versioned_docs/version-22-2/get-started/upgrade-cluster.mdx +++ b/calico-cloud_versioned_docs/version-22-2/get-started/upgrade-cluster.mdx @@ -4,9 +4,10 @@ description: Steps to upgrade to the latest version of Calico Cloud. # Upgrade Calico Cloud -To upgrade managed clusters to the latest version of $[prodname]: +To upgrade a managed cluster to the latest version of $[prodname]: -1. From the web console, go to **Managed Clusters**. +1. From the web console, go to the **Managed Clusters** page. +1. If your organization uses multiple projects to group managed clusters, click the **Project** menu and select the project you want your cluster to be part of. 1. For the cluster you want to upgrade, select **Actions** > **Reinstall**. 1. In the **Reinstall Cluster** dialog, select a newer version of $[prodname] from the list, click **Reinstall**, and copy the generated kubectl command.
diff --git a/calico-cloud_versioned_docs/version-22-2/release-notes/index.mdx b/calico-cloud_versioned_docs/version-22-2/release-notes/index.mdx index 2f269e9893..d318b3543f 100644 --- a/calico-cloud_versioned_docs/version-22-2/release-notes/index.mdx +++ b/calico-cloud_versioned_docs/version-22-2/release-notes/index.mdx @@ -9,7 +9,12 @@ title: Release notes ### New features and enhancements -#### Feature 1 +#### Projects + +This release introduces self-service Projects, allowing you to organize managed clusters into logical groups based on team, environment, or geographic location. +You can now create up to three projects, select hosting regions (North America or Australia), and scope observability tools to specific project environments. + +For more information, see [Projects](../tutorials/calico-cloud-features/projects.mdx). #### Namespaced access to dashboards @@ -317,7 +322,7 @@ For more information, see [Configure an ingress gateway](../networking/ingress-g #### IPAM for load balancers -Calico CLoud now extends its IPAM capabilities to support service LoadBalancer IP allocation, providing a centralized, automated approach to managing LoadBalancer IPs within Kubernetes clusters. +Calico Cloud now extends its IPAM capabilities to support service LoadBalancer IP allocation, providing a centralized, automated approach to managing LoadBalancer IPs within Kubernetes clusters. For more information, see [LoadBalancer IP address management](../networking/ipam/service-loadbalancer.mdx). diff --git a/calico-cloud_versioned_docs/version-22-2/tutorials/calico-cloud-features/projects.mdx b/calico-cloud_versioned_docs/version-22-2/tutorials/calico-cloud-features/projects.mdx new file mode 100644 index 0000000000..da65482095 --- /dev/null +++ b/calico-cloud_versioned_docs/version-22-2/tutorials/calico-cloud-features/projects.mdx @@ -0,0 +1,59 @@ +--- +description: About projects +--- + +import Screenshot from '/src/___new___/components/Screenshot'; + + +# Projects + +You can use projects to organize your managed clusters into logical groupings. + + + +## About projects + +In $[prodname], a *project* is a logical grouping of one or more managed clusters. +You can use projects to organize your managed clusters in ways that are useful for your organization. +For example, you can use projects to segregate clusters by product teams, or by geo location. + +When you view observability tools in Calico Cloud, you see only what is available for the current project. + +All Calico Cloud organizations start with a single default project. +You can have up to three projects at a given time. + +## Create a project + +**Prerequisites** + +* You have Admin or Owner privileges. + +**Procedure** + +1. From any page in the web console, click the **Project** menu and then click **Manage Projects**. +1. On the **Projects** page, click **Add Project**. +1. Enter a name and description for the project, and then click the **Add Project** button. + + Provisioning the new project takes a few minutes. + When provisioning is complete, you can begin connecting clusters. + +## Connect a cluster to a project + +* To connect a cluster to a specific project, make sure you have selected the project you want as you follow the procedure to [connect your cluster to Calico Cloud](../../get-started/install-cluster.mdx). + +## Move a managed cluster to another project + +You can move a managed cluster to another project by removing it from the original project and connecting it to the new project. + +:::warning +Log data held by Calico Cloud will be deleted when you remove your cluster from the original project. +When you reconnect your cluster to Calico Cloud as part of the new project, flow logs will start to be collected again. +You will not be able to restore access to the old logs. + +If you need to retain logs, contact [our support team](https://tigeraio.my.site.com/community/s/login/). +::: + +1. To remove your cluster from Calico Cloud, find your cluster on the **Managed Clusters** page, and then click **Actions > Delete**. + After a moment, the cluster is removed from the list. +1. Move to the new project by clicking the **Projects** menu and selecting your project. +1. To reconnect your cluster, follow the guide to [connect your cluster to Calico Cloud](../../get-started/install-cluster.mdx). diff --git a/calico-cloud_versioned_sidebars/version-22-2-sidebars.json b/calico-cloud_versioned_sidebars/version-22-2-sidebars.json index 4b236f7ef3..d7c2a5f994 100644 --- a/calico-cloud_versioned_sidebars/version-22-2-sidebars.json +++ b/calico-cloud_versioned_sidebars/version-22-2-sidebars.json @@ -78,7 +78,8 @@ "items": [ "tutorials/calico-cloud-features/tour", "tutorials/calico-cloud-features/service-graph", - "tutorials/calico-cloud-features/networksets" + "tutorials/calico-cloud-features/networksets", + "tutorials/calico-cloud-features/projects" ] }, { diff --git a/sidebars-calico-cloud.js b/sidebars-calico-cloud.js index 72787ed3d9..eeb0e0105f 100644 --- a/sidebars-calico-cloud.js +++ b/sidebars-calico-cloud.js @@ -62,6 +62,7 @@ module.exports = { 'tutorials/calico-cloud-features/tour', 'tutorials/calico-cloud-features/service-graph', 'tutorials/calico-cloud-features/networksets', + 'tutorials/calico-cloud-features/projects', ], }, { diff --git a/static/img/calico-cloud/calico-cloud-projects.png b/static/img/calico-cloud/calico-cloud-projects.png new file mode 100644 index 0000000000..27f25132a1 Binary files /dev/null and b/static/img/calico-cloud/calico-cloud-projects.png differ