Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/guillaumefalourd/formulas-aws
Ritchie CLI formulas to create a Kubernetes Cluster on AWS through one command line 🤖 🛠
https://github.com/guillaumefalourd/formulas-aws
automation aws circleci cluster command-line-tool github kubernetes ritchie-cli terraform
Last synced: 2 months ago
JSON representation
Ritchie CLI formulas to create a Kubernetes Cluster on AWS through one command line 🤖 🛠
- Host: GitHub
- URL: https://github.com/guillaumefalourd/formulas-aws
- Owner: GuillaumeFalourd
- License: apache-2.0
- Created: 2020-10-21T15:36:58.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-02-14T16:37:40.000Z (almost 2 years ago)
- Last Synced: 2024-10-12T14:39:00.271Z (3 months ago)
- Topics: automation, aws, circleci, cluster, command-line-tool, github, kubernetes, ritchie-cli, terraform
- Language: Go
- Homepage:
- Size: 261 KB
- Stars: 12
- Watchers: 4
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/GuillaumeFalourd/formulas-aws/actions/workflows/security_pipeline.yml) [](https://github.com/GuillaumeFalourd/formulas-aws/actions/workflows/terraform_security_scan.yml)
# Formulas AWS
## 📚 Documentation
This repository contains Ritchie formulas which can be executed by the [ritchie-cli](https://github.com/ZupIT/ritchie-cli).
- [Ritchie CLI documentation](https://docs.ritchiecli.io)
## 📦 Use Formulas
To import this repository, you need [Ritchie CLI installed](https://docs.ritchiecli.io/getting-started/installation)
Then, you can use the `rit add repo` command manually, or execute the command line below directly on your terminal (since CLI version 2.8.0):
```bash
rit add repo --provider="Github" --name="formulas-aws" --repoUrl="https://github.com/GuillaumeFalourd/formulas-aws" --priority=1
```
Finally, you can check if the repository has been imported correctly by executing the `rit list repo` command.
### 🆙 How to give priority
The commons repository installed through the `rit init` command of Ritchie CLI has duplicated commands with the `formulas-aws` repository.
You have to `set priority 0` for the formulas-aws repository, and `set priority 1` for the commons repository, for the `rit aws create cluster` command to work.
This can be achieved through the `rit set repo-priority` command.
## 🔎 What you'll find in this repository
### ⚠️ Caution
This repository is a **DEMO** to show what is possible to perform using Ritchie CLI.
The formula's templates use specific and sometimes latest providers versions (for aws, terraform, helm, kubernetes, etc...).
Therefore, the pipeline created by the formula may not work without updating the versions compatibility in the future.
If that happens, the recommendation is to fork the repo and update the templates' versions.
## ⚙️ How does it work?
### Youtube Video
[](https://www.youtube.com/watch?v=C3jYQBUf4Us)
### 1 - Execute the `rit aws create cluster`command:
### 2 - Check the code on your repository:
[Repository ritchie-tdc-recife](https://github.com/GuillaumeFalourd/ritchie-tdc-recife/tree/qa)
### 3 - Wait for the pipeline to run on circleci:
### 4 - Check your cluster on AWS:
## 🗃 Sample repositories used for demonstrations:
- **12.04.2020**: [ritchie-tdc-recife](https://github.com/GuillaumeFalourd/ritchie-tdc-recife)
- **10.28.2020**: [ritchie-tdc-poa](https://github.com/GuillaumeFalourd/ritchie-tdc-poa)
- **30.04.2021**: [ritchie-demo-create-cluster](https://github.com/GuillaumeFalourd/ritchie-demo-create-cluster)
## ♻️ Contribute to the repository
### 🆕 Creating formulas
1. Fork and clone the repository
2. Create a branch: `git checkout -b `
3. Check the step by step of [how to create formulas on Ritchie](https://docs.ritchiecli.io/tutorials/formulas/how-to-create-formulas)
4. Add your formulas to the repository
and commit your implementation: `git commit -m '`
5. Push your branch: `git push origin /`
6. Open a pull request on the repository for analysis.
### 🆒 Updating Formulas
1. Fork and clone the repository
2. Create a branch: `git checkout -b `
3. Add the cloned repository to your workspaces (`rit add workspace`) with a highest priority (for example: 1).
4. Check the step by step of [how to implement formulas on Ritchie](https://docs.ritchiecli.io/tutorials/formulas/how-to-implement-a-formula)
and commit your implementation: `git commit -m '`
5. Push your branch: `git push origin /`
6. Open a pull request on the repository for analysis.
- [Contribute to Ritchie community](https://github.com/ZupIT/ritchie-formulas/blob/master/CONTRIBUTING.md)