|
1 | 1 | ## Flightdeck Getting Started Guide
|
2 |
| -This guide walks you through steps for deploying a minimal implementation of Flightdeck, a platform for managing Kubernetes applications. This guide is not a full walk-through of everything needed to utilize Flightdeck, **and should not be considered ready for production** but rather enough of a start to become comfortable with deploying the rest of Flightdeck based on the (Flightdeck Platform Guide)[https://thoughtbot.atlassian.net/wiki/spaces/APG/overview]. |
| 2 | +This guide walks you through steps for deploying a minimal implementation of Flightdeck, a platform for managing Kubernetes applications. This guide is not a full walk-through of everything needed to utilize Flightdeck, **and should not be considered ready for production** but rather enough of a start to become comfortable with deploying the rest of Flightdeck based on the [Flightdeck Platform Guide](https://thoughtbot.atlassian.net/wiki/spaces/APG/overview). |
3 | 3 |
|
4 | 4 | ### Prerequisites
|
5 | 5 | Deploying Flightdeck has several crucial prerequisites such as setting up a 1Password account, selecting an Identity Provider for SSO, and leveraging AWS Control Tower for multi-account architecture. In scope of this Getting Started Guide, many of these steps can be skipped, but there are a few which are still required:
|
6 |
| -* **AWS Account**: this can be done for free at (AWS Free-Tier Signup)[https://aws.amazon.com/free/] or leverage an account already provided, utilizing whatever sign on and permissions are provided through the organization. |
7 |
| -* **AWS CLI**: Install configure AWS CLI following the (AWS Getting Started Guide)[https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html]. |
8 |
| -* **Development Tools**: Download and install (Terraform)[https://developer.hashicorp.com/terraform/install] and (Docker)[https://docs.docker.com/engine/install/] from their respective official website. |
9 |
| -For more information on installing the full Flightdeck prerequisites, see the (Landing Zone)[https://thoughtbot.atlassian.net/wiki/spaces/APG/pages/124977153/Landing+Zone] and (Install)[https://thoughtbot.atlassian.net/wiki/spaces/APG/pages/11304961/Install] sections of the Platform Guide. |
| 6 | +* **AWS Account**: this can be done for free at [AWS Free-Tier Signup](https://aws.amazon.com/free/) or leverage an account already provided, utilizing whatever sign on and permissions are provided through the organization. |
| 7 | +* **AWS CLI**: Install configure AWS CLI following the [AWS Getting Started Guide](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html). |
| 8 | +* **Development Tools**: Download and install [Terraform](https://developer.hashicorp.com/terraform/install) and [Docker](https://docs.docker.com/engine/install/) from their respective official website. |
| 9 | +For more information on installing the full Flightdeck prerequisites, see the [Landing Zone](https://thoughtbot.atlassian.net/wiki/spaces/APG/pages/124977153/Landing+Zone) and [Install](https://thoughtbot.atlassian.net/wiki/spaces/APG/pages/11304961/Install) sections of the Platform Guide. |
10 | 10 |
|
11 | 11 | ### Step 1: Deploy Flightdeck Kubernetes Clusters
|
12 | 12 | Flightdeck requires Kubernetes clusters on AWS’s EKS platform:
|
13 |
| -* Cluster Configuration: Use Flightdeck's cluster Terraform module to set up compatible EKS clusters. Follow the steps outlined in the (Makefile)[https://github.com/thoughtbot/flightdeck/blob/christi-adding-getting-started/getting-started/Makefile], or simply run `make cluster`. from this getting started-folder -- though it is always advised to read through any type of script before running it! |
| 13 | +* Cluster Configuration: Use Flightdeck's cluster Terraform module to set up compatible EKS clusters. Follow the steps outlined in the [Makefile](https://github.com/thoughtbot/flightdeck/blob/christi-adding-getting-started/getting-started/Makefile), or simply run `make cluster` from this getting started-folder -- though it is always advised to read through any type of script before running it! |
14 | 14 |
|
15 | 15 | ### Step 2 ~ n: TODO
|
16 | 16 |
|
17 | 17 | ### Step TODO: Deploy Example Application
|
18 |
| -TODO -- The example-app folder contains a Dockerfile describing implementation for an nginx server, an nginx.conf file, and a **Hello, World** HTML file. Follow the steps in the `docker` command located in the (Makefile)[https://github.com/thoughtbot/flightdeck/blob/christi-adding-getting-started/getting-started/Makefile], or simply run `make docker` from this getting-started folder. |
| 18 | +TODO -- The example-app folder contains a Dockerfile describing implementation for an nginx server, an nginx.conf file, and a **Hello, World** HTML file. Follow the steps in the `docker` command located in the [Makefile](https://github.com/thoughtbot/flightdeck/blob/christi-adding-getting-started/getting-started/Makefile), or simply run `make docker` from this getting-started folder. |
19 | 19 |
|
20 | 20 | ### Step TODO: Monitoring Setup
|
21 | 21 | TODO -- Deploy Grafana: After deploying Flightdeck, proceed with deploying Grafana for effective monitoring of your infrastructure and applications.
|
22 | 22 |
|
23 | 23 | ### Conclusion
|
24 |
| -By following these steps, you'll have set up a minimal Kubernetes-based platform using Flightdeck. This guide provides a foundational approach, and you should adapt it to your specific organizational requirements and workflow. Need more help, beyond the Platform Guide? Please feel free to reach out to the (code owners)[https://github.com/thoughtbot/flightdeck/blob/christi-adding-getting-started/CODEOWNERS], or consult with a (Thoughtbot Flightdeck Engineer)[https://thoughtbot.com/hire-us] on how Flightdeck can be installed and maintained for your organization by seasoned professionals! |
| 24 | +By following these steps, you'll have set up a minimal Kubernetes-based platform using Flightdeck. This guide provides a foundational approach, and you should adapt it to your specific organizational requirements and workflow. Need more help, beyond the Platform Guide? Please feel free to reach out to the [code owners](https://github.com/thoughtbot/flightdeck/blob/christi-adding-getting-started/CODEOWNERS), or consult with a [Thoughtbot Flightdeck Engineer](https://thoughtbot.com/hire-us) on how Flightdeck can be installed and maintained for your organization by seasoned professionals! |
0 commit comments