<h1>Quick Start with GKE </h1>

Manage your GKE clusters with Meshery. Deploy Meshery in GKE in-cluster or outside of GKE out-of-cluster. Note: It is advisable to install Meshery in your GKE clusters

<div class="prereqs"><p><strong style="font-size: 20px;">Prerequisites</strong> </p> <ol> <li>Install the Meshery command line client, <a href="{{< ref "installation/mesheryctl/_index.md" >}}" class="meshery-light">mesheryctl</a>.</li> <li>Install <a href="https://kubernetes.io/docs/tasks/tools/">kubectl</a> on your local machine.</li> <li>Install <a href="https://cloud.google.com/sdk/docs/install">gcloud CLI</a>, configured for your environment.</li> <li>Access to an active GKE cluster in your Google Cloud project.</li> </ol> </div>

Also see: [Install Meshery on Kubernetes]({{< ref "installation/kubernetes/_index.md" >}})

Available Deployment Methods

• In-cluster Installation
  • Preflight Checks
    • Preflight: Cluster Connectivity
    • Preflight: Plan your access to Meshery UI
  • Installation: Using mesheryctl
  • Installation: Using Helm
  • Post-Installation Steps

In-cluster Installation

Follow the steps below to install Meshery in your GKE cluster.

Preflight Checks

Read through the following considerations prior to deploying Meshery on GKE.

Preflight: Cluster Connectivity

1. Verify your connection to a Google Kubernetes Engine Cluster using the gcloud CLI.
2. Log in to your GCP account using gcloud auth login.
3. After a successful login, set the Project Id:

{{< code code="gcloud config set project [PROJECT_ID]" >}}

1. After setting the Project Id, set the cluster context.

{{< code code="gcloud container clusters get-credentials [CLUSTER_NAME] --zone [CLUSTER_ZONE]" >}}

1. Verify your kubeconfig's current context.

{{< code code="kubectl config current-context" >}}

Preflight: Plan your access to Meshery UI

1. If you are using port-forwarding, please refer to the [port-forwarding]({{< ref "reference/references/mesheryctl/system/dashboard.md" >}}) guide for detailed instructions.
2. If you are using a LoadBalancer, please refer to the [LoadBalancer]({{< ref "installation/kubernetes/_index.md#exposing-meshery-serviceloadbalancer" >}}) guide for detailed instructions.
3. Customize your Meshery Provider Callback URL. Meshery Server supports customizing authentication flow callback URL, which can be configured in the following way:

{{< code code="MESHERY_SERVER_CALLBACK_URL=https://custom-host mesheryctl system start" >}}

Meshery should now be running in your GKE cluster, and the Meshery UI should be accessible at the EXTERNAL IP of the meshery service.

Installation: Using mesheryctl

Use Meshery's CLI to streamline your connection to your GKE cluster. Configure Meshery to connect to your GKE cluster by executing:

{{< code code="mesheryctl system config gke" >}}

Once configured, execute the following command to start Meshery.

{{< code code="mesheryctl system start" >}}

If you encounter any authentication issues, you can use mesheryctl system login. For more information, click [here]({{< ref "guides/mesheryctl/authenticate-with-meshery-via-cli/index.md" >}}) to learn more.

Installation: Using Helm

For detailed instructions on installing Meshery using Helm V3, please refer to the [Helm Installation]({{< ref "installation/kubernetes/helm.md" >}}) guide.

Post-Installation Steps

Optionally, you can verify the health of your Meshery deployment using <a href='{{< ref "reference/references/mesheryctl/system/check.md" >}}'>mesheryctl system check</a>.

You're ready to use Meshery! Open your browser and navigate to the Meshery UI.

{{< installation/accessing-meshery-ui >}}

{{< related-discussions tag="meshery" >}}