{"id":18318487,"url":"https://github.com/garden-io/garden-aws-quickstart","last_synced_at":"2025-04-05T21:32:51.194Z","repository":{"id":176432521,"uuid":"614909195","full_name":"garden-io/garden-aws-quickstart","owner":"garden-io","description":"Garden AWS Quickstart solution for production-like development clusters on AWS.","archived":true,"fork":false,"pushed_at":"2024-06-17T09:20:22.000Z","size":602,"stargazers_count":13,"open_issues_count":3,"forks_count":0,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-03-01T06:19:12.890Z","etag":null,"topics":["aws","ci","devex","devops","garden"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/garden-io.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-03-16T15:02:12.000Z","updated_at":"2024-08-12T08:36:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"d8df7e71-702e-4a9f-9e47-9d4b573e053a","html_url":"https://github.com/garden-io/garden-aws-quickstart","commit_stats":{"total_commits":29,"total_committers":6,"mean_commits":4.833333333333333,"dds":0.6551724137931034,"last_synced_commit":"db485e099b7edd8623fc0bbade2c6e03d9975385"},"previous_names":["garden-io/garden-aws-quickstart"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garden-io%2Fgarden-aws-quickstart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garden-io%2Fgarden-aws-quickstart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garden-io%2Fgarden-aws-quickstart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garden-io%2Fgarden-aws-quickstart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/garden-io","download_url":"https://codeload.github.com/garden-io/garden-aws-quickstart/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247406080,"owners_count":20933803,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","ci","devex","devops","garden"],"created_at":"2024-11-05T18:09:48.354Z","updated_at":"2025-04-05T21:32:50.862Z","avatar_url":"https://github.com/garden-io.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Garden Development Cluster Solution for AWS\n\n## Features\n- **Remote development:** Use an Amazon EKS cluster as a remote development environment for your engineering team, as well as for CI and QA environments.\n- **Fast builds:** Save precious engineering time wasted waiting for container builds by using the [in-cluster-building](https://docs.garden.io/kubernetes-plugins/advanced/in-cluster-building) and [build caching](https://docs.garden.io/basics/how-garden-works#caching) features. Your container images will be stored in AWS ECR repositories.\n- **Autoscaling:** Control the minimum and maximum number of nodes in the cluster, to support your Engineering team size and workload requirements\n- **Access management:** Easily grant access to your development teams, so they can use remote production-like dev environments and see changes reflected instantly with [Garden sync mode](https://docs.garden.io/guides/code-synchronization).  This  will make the remote development environment feel like running your set of services locally.\n- **Batteries included:** Also takes care of Load Balancing, Ingress controller, SSL certificates and Route53 supporting any number of development environments right away. The EKS cluster comes already with all necessary IAM permissions preconfigured that Garden needs to function.\n\n## High-level architecture overview\n\n![plot](./Architecture_diagram_dev_cluster.png)\n\n## Quick start\n\nAfter completing the following steps, you will have deployed your dev environment for the [Garden quick-start example](https://github.com/garden-io/quickstart-example) to your Garden Development Cluster on AWS.\n\n### 1. DNS Setup\n\nTo make your development environments accessible for your engineering and QA teams you need to choose a domain name that we will use for the Quickstart cluster. You need to be the owner of that domain and be able to create DNS records.\n\nWhen using `gardendev.example.com`, your development and QA environments would be reachable on any of the subdomains (`*.gardendev.example.com`) once you completed the quick start steps.\n\nIf this DNS name is not already hosted on AWS Route 53, you need to [create a hosted zone](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/CreatingHostedZone.html) for it first, and also complete step 8 of that guide to make AWS Route 53 DNS servers authoritative for the chosen DNS name.\n\n### 2. Deploy the solution\n\nNow you can deploy the solution using AWS CloudFormation. \n\n\u003c!-- x-release-please-start-version --\u003e\nFollow the link to the [Quick install](https://console.aws.amazon.com/cloudformation/home#/stacks/quickcreate?stackName=garden-dev-cluster\u0026templateURL=https://garden-cfn-public-releases.s3.amazonaws.com/dev-cluster/0.5.0/garden-dev-cluster.template.yaml) template ([View Template Source](https://garden-cfn-public-releases.s3.amazonaws.com/dev-cluster/0.5.0/garden-dev-cluster.template.yaml)).\n\u003c!-- x-release-please-end --\u003e\n\n#### Parameters\n\nPlease refer to the [parameters reference](docs/reference/parameters.md) for a description of all parameters.\n\nThe following parameters will need to be configured to launch the quickstart guide. You can keep the default value for all other parameters.\n\n##### `IAMEKSFullAccessPrincipals`\nList of ARN principals, like IAM users or roles, that should be allowed to assume the role to get access to the EKS cluster. Mutually exclusive with the `IAMEKSFullAccessRole` parameter. You must either supply an `IAMEKSFullAccessRole` parameter, or `IAMEKSFullAccessPrincipals`, but not both.\n\nExample: `arn:aws:iam::001122334455:user/anna,arn:aws:iam::001122334455:user/steffen,arn:aws:iam::001122334455:user/srihas`\n\n##### `IAMEKSFullAccessRole`\nThe ARN of the IAM role that gets access to the EKS cluster. Everyone who can assume this role will have full access to the EKS cluster created in this stack. You are responsible for managing the trust policy of this role and allow users to assume it. Mutually exclusive with `IAMEKSFullAccessPrincipals` parameter. You must either supply an `IAMEKSFullAccessRole` parameter, or `IAMEKSFullAccessPrincipals`, but not both.\n\nIn case you are using AWS Single Sign On (also known as AWS Identity Center) you will want to specify the `AWSReservedSSO` role that your development teams can assume in `IAMEKSFullAccessRole`.\n\nExample: `arn:aws:iam::001122334455:role/AWSReservedSSO_DeveloperAccess_xxxxxxxx`\n\n##### `IngressRoute53HostedZoneId`\nThe ID of the Route53 hosted zone with the domain that can be used for ingress to the development environments\n\nUse the drop down to choose the hosted zone ID that hosts the domain chosen in [step 1 (DNS Setup)](#1-dns-setup).\n\n##### `IngressRoute53HostedZoneId`\nThe subdomain that can be used for ingress to the development environments. Needs to be a hosted domain in `Route53RecordTarget`, for example: `garden.mycompany.com`.\n\nEnter the domain chosen in [step 1 (DNS Setup)](#1-dns-setup).\n\n### 3. Deploy the quickstart-example\n1. `git clone https://github.com/garden-io/quickstart-example.git`\n2. `cd quickstart-example`\n3. Update the Kubernetes provider configuration in `project.garden.yml`\n4. `garden dev`\n5. `\u003e deploy --sync`\n\n## Telemetry\n\nWhen launching, updating or deleting the CloudFormation Stack we collect anonymized telemetry and send it to Segment.io. It helps us understand how our users use Garden and aids our decision process when prioritizing new features, bug fixing, etc.\n\nWe put great effort in making sure we only collect completely anonymized data by hashing sensitive information using SHA-512. See also the implementation at [`src/functions/tracking.ts`](src/functions/tracking.ts).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarden-io%2Fgarden-aws-quickstart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgarden-io%2Fgarden-aws-quickstart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarden-io%2Fgarden-aws-quickstart/lists"}