{"id":15156351,"url":"https://github.com/coreos/terraform-aws-kubernetes","last_synced_at":"2025-09-30T04:32:23.060Z","repository":{"id":55054537,"uuid":"102916118","full_name":"coreos/terraform-aws-kubernetes","owner":"coreos","description":"Install a Kubernetes cluster the CoreOS Tectonic Way: HA, self-hosted, RBAC, etcd Operator, and more","archived":true,"fork":false,"pushed_at":"2018-03-16T14:06:25.000Z","size":104,"stargazers_count":116,"open_issues_count":8,"forks_count":67,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-09-27T19:20:38.039Z","etag":null,"topics":["aws","coreos","kubernetes","tectonic","terraform","terraform-modules"],"latest_commit_sha":null,"homepage":"","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coreos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-09T00:54:09.000Z","updated_at":"2024-02-17T14:44:34.000Z","dependencies_parsed_at":"2022-08-14T10:20:17.517Z","dependency_job_id":null,"html_url":"https://github.com/coreos/terraform-aws-kubernetes","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Fterraform-aws-kubernetes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Fterraform-aws-kubernetes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Fterraform-aws-kubernetes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Fterraform-aws-kubernetes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coreos","download_url":"https://codeload.github.com/coreos/terraform-aws-kubernetes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234702069,"owners_count":18873824,"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","coreos","kubernetes","tectonic","terraform","terraform-modules"],"created_at":"2024-09-26T19:20:24.534Z","updated_at":"2025-09-30T04:32:17.781Z","avatar_url":"https://github.com/coreos.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Install Tectonic on AWS with Terraform\n\nThis module deploys a [Tectonic][tectonic] Kubernetes cluster on an AWS account using [Terraform][terraform]. Tectonic is an enterprise-ready distribution of Kubernetes including automatic updates, monitoring and alerting, integration with common authentication regimes, and a graphical console for managing clusters in a web browser.\n\nThis module can deploy either a complete Tectonic cluster, requiring a Tectonic license, or a \"stock\" Kubernetes cluster without Tectonic features.\n\nTo install Tectonic on AWS with a graphical installer instead, refer to the [Tectonic graphical installer documentation][aws-gui].\n\nThe AWS platform templates adhere to the standards defined by the project [conventions][conventions] and [generic platform requirements][generic]. This document details the specifics of the AWS platform.\n\n## Getting Started\n\n### Customize the deployment\n\nCustomizations to the base installation are made to the Terraform variables for each deployment. Examples of the the Tectonic-specific variables are provided in the file `examples/kubernetes.tf`.\n\nEdit the parameters with your AWS details, domain name, and [Tectonic license][register]. To install a basic Kubernetes cluster without Tectonic features, set the `tectonic_vanilla_k8s` key to `true` and omit the Tectonic license.\n\n[View all of the AWS specific options and the common Tectonic variables][vars].\n\n### Initialize and configure Terraform\n\n#### Get Terraform's AWS modules and providers\n\nGet the modules and providers that Terraform will use to create the cluster resources:\n\n```bash\n$ terraform init\nDownloading modules...\nGet: git::https://github.com/coreos/tectonic-installer.git?ref=1d75718d96c7bdec04d5ffb8a72fa059b1fcb79a\nGet: git::https://github.com/coreos/tectonic-installer.git?ref=1d75718d96c7bdec04d5ffb8a72fa059b1fcb79a\n...\n\nInitializing provider plugins...\n- Downloading plugin for provider \"template\"...\n- Downloading plugin for provider \"ignition\"...\n- Downloading plugin for provider \"aws\"...\n...\n```\n\n### Deploy the cluster\n\nTest the blueprint before deploying:\n\n```bash\n$ terraform plan\n```\n\nNext, deploy the cluster:\n\n```bash\n$ terraform apply\n```\n\nThis should run for a short time, and when complete, the cluster should be ready.\n\n### Access the cluster\n\nThe Tectonic Console should be up and running after the containers have downloaded. You can access it at the DNS name formed by concatenating the cluster name with the domain configured in the Terraform variables.\n\nCluster credentials are written beneath the `generated/` directory, including any generated CA certificate and a `kubeconfig` file. You can use this to access the cluster with `kubectl`. This is the only method of access for a Kubernetes cluster installed without Tectonic features:\n\n```bash\n$ export KUBECONFIG=generated/auth/kubeconfig\n$ kubectl cluster-info\n```\n\n## Work with the cluster\n\nFor more information on working with installed clusters, see [Scaling Tectonic AWS clusters][scale-aws], and [Uninstalling Tectonic][uninstall].\n\n## Known issues and workarounds\n\nSee the [troubleshooting][troubleshooting] document for workarounds and known issues.\n\n\n[conventions]: https://github.com/coreos/tectonic-docs/blob/master/Documentation/conventions.md\n[generic]: https://github.com/coreos/tectonic-docs/blob/master/Documentation/generic-platform.md\n[env]: http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-environment\n[register]: https://account.coreos.com/signup/summary/tectonic-2016-12\n[account]: https://account.coreos.com\n[vars]: https://github.com/coreos/terraform-aws-kubernetes/blob/master/variables.md\n[troubleshooting]: https://github.com/coreos/tectonic-docs/blob/master/Documentation/troubleshooting/faq.md\n[aws-gui]: https://coreos.com/tectonic/docs/latest/install/aws/index.html\n[terraform]: https://www.terraform.io/downloads.html\n[uninstall]: https://github.com/coreos/tectonic-docs/blob/master/Documentation/install/aws/uninstall.md\n[scale-aws]: https://github.com/coreos/tectonic-docs/blob/master/Documentation/admin/aws-scale.md\n[release-notes]: https://coreos.com/tectonic/releases/\n[verification-key]: https://coreos.com/security/app-signing-key/\n[tectonic]: https://coreos.com/tectonic/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoreos%2Fterraform-aws-kubernetes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoreos%2Fterraform-aws-kubernetes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoreos%2Fterraform-aws-kubernetes/lists"}