Project: Meshery (Provisioning / Automation & Configuration)
File: eks.md

layout: default title: EKS permalink: installation/kubernetes/eks type: installation category: kubernetes redirect_from: installation/platforms/eks display-title: "false" language: en list: include image: /assets/img/platforms/eks.png abstract: Install Meshery on Elastic Kubernetes Service. Deploy Meshery in EKS in-cluster or outside of EKS out-of-cluster. <h1>Quick Start with {{ page.title }} <img src="{{ page.image }}" style="width:35px;height:35px;" /></h1> Manage your EKS clusters with Meshery. Deploy Meshery in EKS or outside of EKS . _Note: It is advisable to _ <div class="prereqs"><h4>Prerequisites</h4> <ol> <li>Install the Meshery command line client, <a href="{{ site.baseurl }}/installation/mesheryctl" 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://docs.aws.amazon.com/eks/latest/userguide/getting-started.html">AWS CLI</a>, configured for your environment.</li> <li>Access to an active EKS cluster in AWS Account.</li> </ol> </div> Also see: - - - - Follow the steps below to install Meshery in your EKS cluster. Read through the following considerations prior to deploying Meshery on EKS. Verfiy you connection to an Elastic Kubernetes Services Cluster using AWS CLI. Login to AWS account using , if you are using a different method of authentication in AWS, please refer to AWS documentation. After successful login, set the cluster context. {% capture codecontent %}aws eks update-kubeconfig --name [YOURCLUSTERNAME] --region [YOURREGION]{% endcapture %} {% include code.html code=code_content %} Optional: If you are using `eksctl`, follow the . Verify your kubeconfig's current context. {% capture code_content %}kubectl config current-context{% endcapture %} {% include code.html code=code_content %} Use Meshery's CLI to streamline your connection to your EKS cluster. Configure Meshery to connect to your EKS cluster by executing: {% capture code_content %}$ mesheryctl system config eks{% endcapture %} {% include code.html code=code_content %} Once configured, execute the following command to start Meshery. {% capture code_content %}$ mesheryctl system start{% endcapture %} {% include code.html code=code_content %} For detailed instructions on installing Meshery using Helm V3, please refer to the guide. Optionally, you can verify the health of your Meshery deployment, using <a href='/reference/mesheryctl/system/check'>mesheryctl system check</a>. You're ready to use Meshery! Open your browser and navigate to the Meshery UI. {% include_cached installation/accessing-meshery-ui.md display-title="true" %} {% include alert.html title='Out-of-cluster EKS deployments not currently supported' type="warning" alert='Out-of-cluster support for EKS is still beta and on <a href="https://github.com/meshery/meshery/blob/master/ROADMAP.md">roadmap</a>.' %} Install Meshery on Docker (out-of-cluster) and connect it to your EKS cluster. {% capture code_content %}$ mesheryctl system start -p docker{% endcapture %} {% include code.html code=code_content %} Configure Meshery to connect to your cluster by executing: {% capture code_content %}$ mesheryctl system config eks{% endcapture %} {% include code.html code=code_content %} Once you have verified that all the services are up and running, Meshery UI will be accessible on your local machine on port 9081. Open your browser and access Meshery at . {% include related-discussions.html tag="meshery" %}