DOCS-2826: Docs for CC projects

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.

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.

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.
 

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.
    <details>

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.
+
+<Screenshot src="/img/calico-cloud/calico-cloud-projects.png" alt="Project page" />
+
+## 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).

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.

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.

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.
 

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.
    <details>

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).
 

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.
+
+<Screenshot src="/img/calico-cloud/calico-cloud-projects.png" alt="Project page" />
+
+## 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).

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"
           ]
         },
         {

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',
           ],
         },
         {