Docs feedback: Create a Google GKE cluster instructions are out of sequence

Create a Google GKE cluster

The sequence provided looks like this:

1. Import the example project.
2. Register the agent for Kubernetes.
3. Create your GCP credentials.
4. Configure your project.
5. Provision your cluster.

But it isn't possible to register the agent before the cluster has been created. And the project needs to be configured before the pipeline can be run.

It probably should be something like:

1. Create your GCP credentials
2. Import the example project
3. Configure your project
4. Provision your cluster
5. Register the agent for Kubernetes - this step cannot happen until a cluster exists.

I've had a few customers comment that the whole process is hard to follow and this page seems to be the crux of the problem.

added documentation label

assigned to @phillipwells

changed title from Docs feedback: Create a Google GKE cluster page feels out of sequence to Docs feedback: Create a Google GKE cluster instructions are out of sequence

added groupenvironments label

added devopsdeploy sectioncd labels

Note: I may be wrong about the order. I am working through this now and will update today (17 Jan, 25)

It seems like I can create an agent without having a cluster stood up - which feels counterintuitive.

I was able to follow the steps and get the pipeline configured but it failed saying I should be using OpenTofu.

I reached out to the Deploy team to see what they recommend. Either way, it feels like a doc change is needed.

mentioned in issue gitlab-org/quality/triage-reports#21892 (closed)

I am closing this as the docs are technically correct. I will likely open an MR to add some claritying language.

closed

added typemaintenance label