/20_weaveworks_prerequisites.html Recent content in Prerequisites for all GitOps Workshops on Weaveworks Introduction to GitOps w/ AWS EKS Hugo -- gohugo.io en-US /20_weaveworks_prerequisites/10_workspace.html Mon, 01 Jan 0001 00:00:00 +0000 /20_weaveworks_prerequisites/10_workspace.html AWS Cloud9 is a cloud-based integrated development environment (IDE) that lets you write, run, and debug your code with just a browser. It includes a code editor, debugger, and terminal. Cloud9 comes prepackaged with essential tools for popular programming languages, including JavaScript, Python, PHP, and more, so you don’t need to install files or configure your development machine to start new projects. Ad blockers, javascript disablers, and tracking blockers should be disabled for the cloud9 domain, or connecting to the workspace might be impacted. /20_weaveworks_prerequisites/11_install_eksctl.html Mon, 01 Jan 0001 00:00:00 +0000 /20_weaveworks_prerequisites/11_install_eksctl.html For this workshop you will use a eksctl. Once you install eksctl, you will be ready to get started. At the terminal command prompt, enter the following two commands: curl --silent --location "https://github.com/weaveworks/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz" | tar xz -C /tmp sudo mv /tmp/eksctl /usr/local/bin This will install eksctl in your Cloud9 environment. To test to make sure the command is installed properly, execute the command: eksctl get cluster You should get a “No clusters found” message. /20_weaveworks_prerequisites/12_install_kubectl.html Mon, 01 Jan 0001 00:00:00 +0000 /20_weaveworks_prerequisites/12_install_kubectl.html The Kubernetes command-line tool, kubectl, allows you to run commands against Kubernetes clusters. You can use kubectl to deploy applications, inspect and manage cluster resources, and view logs. At the terminal command prompt, enter the following two commands: curl -LO https://storage.googleapis.com/kubernetes-release/release/`curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt`/bin/linux/amd64/kubectl chmod +x ./kubectl sudo mv ./kubectl /usr/local/bin/kubectl This will install kubectl in your Cloud9 environment. To test to make sure the command is installed properly, execute the command: /20_weaveworks_prerequisites/13_install_helm.html Mon, 01 Jan 0001 00:00:00 +0000 /20_weaveworks_prerequisites/13_install_helm.html Helm describes itself as a ‘package manager for kubernetes’ and can be used to deploy resources to Kubernetes. You package your application as a chart which can contain templated files (usually Kubernetes resources) and default configuration values too use when rendering the template. Charts are reusable and values can be overriden for specific environments. We are using Helm v3 in the workshops. So there is no tiller. If you are using your own environment and not the workshops Cloud9 environment and you have Helm v2 the commands should work ok. /20_weaveworks_prerequisites/14_install_fluxctl.html Mon, 01 Jan 0001 00:00:00 +0000 /20_weaveworks_prerequisites/14_install_fluxctl.html Install Fluxctl Fluxctl is a CLI tool that is able to talk to Weave Flux. Install by running this command: curl -Ls https://fluxcd.io/install | sh && \ sudo mv $HOME/.fluxcd/bin/fluxctl /usr/local/bin/fluxctl Verify the installation: fluxctl version /20_weaveworks_prerequisites/15_install_kustomize.html Mon, 01 Jan 0001 00:00:00 +0000 /20_weaveworks_prerequisites/15_install_kustomize.html Install Kustomize Kustomize lets you customize raw, template-free YAML files for multiple purposes, leaving the original YAML untouched and usable as is. Install kustomize for Linux: curl --silent --location --remote-name \ "https://github.com/kubernetes-sigs/kustomize/releases/download/kustomize/v3.2.3/kustomize_kustomize.v3.2.3_linux_amd64" && \ chmod a+x kustomize_kustomize.v3.2.3_linux_amd64 && \ sudo mv kustomize_kustomize.v3.2.3_linux_amd64 /usr/local/bin/kustomize Verify the install with: kustomize version /20_weaveworks_prerequisites/16_install_aws-iam.html Mon, 01 Jan 0001 00:00:00 +0000 /20_weaveworks_prerequisites/16_install_aws-iam.html Amazon EKS uses IAM to provide authentication to your Kubernetes cluster through the AWS IAM authenticator for Kubernetes. You can configure the stock kubectl client to work with Amazon EKS by installing the AWS IAM authenticator for Kubernetes and modifying your kubectl configuration file to use it for authentication. To install aws-iam-authenticator on Cloud9 Download the Amazon EKS-vended aws-iam-authenticator binary from Amazon S3: curl -o aws-iam-authenticator https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.10/2020-02-22/bin/linux/amd64/aws-iam-authenticator Apply execute permissions to the binary: /20_weaveworks_prerequisites/17_add_the_role.html Mon, 01 Jan 0001 00:00:00 +0000 /20_weaveworks_prerequisites/17_add_the_role.html Creating and using EKS clusters in AWS requires specific IAM roles for the user creating and accessing EKS clusters. Switch to the AWS Console (You can open the console from the “Team Dashboard”) Under Services, select EC2 Click Running Instances Select the instance named “aws-cloud9-…” by clicking the check box to the left of the name On Actions pull down, select Instance Settings -> Attach/Replace IAM Role In the IAM role pull down, select TeamRoleInstanceProfile To the right, click Apply /20_weaveworks_prerequisites/50_workspaceiam.html Mon, 01 Jan 0001 00:00:00 +0000 /20_weaveworks_prerequisites/50_workspaceiam.html Cloud9 normally manages IAM credentials dynamically. This isn’t currently compatible with the EKS IAM authentication, so we will disable it and rely on the IAM role instead. Return to your workspace and click the gear icon (in top right corner), or click to open a new tab and choose “Open Preferences” Select AWS SETTINGS Turn off AWS managed temporary credentials Close the Preferences tab To ensure temporary credentials aren’t already in place we will also remove any existing credentials file: