fix: working documentation for running with docker (#429)

Author: ShubyM

CONTAINER.md

@@ -0,0 +1,49 @@
+# 1. Build the Docker Image 
+
+First, clone the `kubectl-ai` repository and build the Docker image from the source code.
+
+```bash
+git clone https://github.com/GoogleCloudPlatform/kubectl-ai.git
+cd kubectl-ai
+docker build -t kubectl-ai:latest -f images/kubectl-ai/Dockerfile .
+```
+
+# 2. Running against a GKE cluster
+To access a GKE cluster, `kubectl-ai` needs two configurations from your local machine: **Google Cloud credentials** and a **Kubernetes config file**.
+
+## Create Google Cloud Credentials
+
+First, create Application Default Credentials [(ADC)](https://cloud.google.com/docs/authentication/application-default-credentials). `kubectl` uses these credentials to authenticate with your GKE cluster.
+
+```bash
+gcloud auth application-default login
+```
+
+This command saves your credentials into the `~/.config/gcloud` directory.
+
+## Configure `kubectl`
+
+Next, generate the `kubeconfig` file. This file tells `kubectl` which cluster to connect to and to use your ADC credentials for authentication.
+
+```bash
+gcloud container clusters get-credentials <cluster-name> --location <location>
+```
+
+This updates the configuration file at `~/.kube/config`.
+
+# 3. Running the Container
+
+Finally, mount both configuration directories into the `kubectl-ai` container when you run it.
+This example shows how to run `kubectl-ai` with a web interface, mounting all necessary credentials and providing a Gemini API key.
+
+```bash
+export GEMINI_API_KEY="your_api_key_here"
+docker run --rm -it -p 8080:8080 -v ~/.kube:/root/.kube -v ~/.config/gcloud:/root/.config/gcloud -e GEMINI_API_KEY kubectl-ai:latest --ui-listen-address 0.0.0.0:8080 --ui-type web
+```
+
+Alternativley with the default terminal ui:
+
+```bash
+export GEMINI_API_KEY="your_api_key_here"
+docker run --rm -it -v ~/.kube:/root/.kube -v ~/.config/gcloud:/root/.config/gcloud -e GEMINI_API_KEY kubectl-ai:latest 
+```

README.md

@@ -311,26 +311,22 @@ docker build -t kubectl-ai:latest -f images/kubectl-ai/Dockerfile .
 ```
 
 #### Step 2: Connect to Your GKE Cluster
-Grab credentails for your cluster using the following commands
+Set up application default credentials and connect to your GKE cluster.
 ```bash
-gcloud auth login
+gcloud auth application-default login # If in a gcloud shell this is not necessary
 gcloud container clusters get-credentials <cluster-name> --zone <zone>
 ```
 
 #### Step 3: Run the kubectl-ai container
-Below is a sample command that can be used to launch the container with a locally hosted web-ui. Be sure to replace the placeholder values with your specific Google Cloud project ID and location.
+Below is a sample command that can be used to launch the container with a locally hosted web-ui. Be sure to replace the placeholder values with your specific Google Cloud project ID and location. Note you 
+do not need to mount the gcloud config directory if you're on a cloudshell machine. 
 
 ```bash
-docker run --rm -it \
-  -p 8080:8080 \
-  -v ~/.kube:/root/.kube:ro \
-  -v ~/.config/gcloud:/root/.config/gcloud
-  kubectl-ai:latest \
-  --llm-provider vertexai \
-  --ui-listen-address 0.0.0.0:8080 \
-  --ui-type web
+docker run --rm -it -p 8080:8080 -v ~/.kube:/root/.kube -v ~/.config/gcloud:/root/.config/gcloud -e GOOGLE_CLOUD_LOCATION=us-central1 -e GOOGLE_CLOUD_PROJECT=my-gcp-project kubectl-ai:latest --llm-provider vertexai --ui-listen-address 0.0.0.0:8080 --ui-type web
 ```
 
+For more info about running from the container image see [CONTAINER.md](CONTAINER.md)
+
 ## MCP Client Mode
 
 > **Note:** MCP Client Mode is available in `kubectl-ai` version v0.0.12 and onwards.

images/kubectl-ai/Dockerfile

@@ -1,7 +1,7 @@
 ARG GO_VERSION="1.24.3"
 ARG GCLOUD_CLI_VERSION="530.0.0-stable"
 
-FROM golang:${GO_VERSION}-bookworm as builder
+FROM golang:${GO_VERSION}-bookworm AS builder
 
 WORKDIR /src
 COPY go.mod go.sum ./