An open API service indexing awesome lists of open source software.

https://github.com/jd-apprentice/easy-static

🧰 simple static site deployment tool
https://github.com/jd-apprentice/easy-static

Last synced: 14 days ago
JSON representation

🧰 simple static site deployment tool

Awesome Lists containing this project

README

          

# easy static - static site deployment tool



Manage your static site with ease. Easy Static is a simple static site deployment tool that allows you to deploy your static site to multiple hosts with a single command.

# Table of Contents

1. [Design 🖌](#design-)
2. [Software requirements 📦](#software-requirements-)
3. [File structure 📁](#file-structure-)
4. [Documentation 📕](#documentation-)
5. [License 📰](#license-)

## Design 🖌



![infra](design/infra.png)

## Software requirements 📦

For local development

- [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html)
- [Terraform](https://learn.hashicorp.com/tutorials/terraform/install-cli)
- [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
- [jq](https://stedolan.github.io/jq/download/)
- [pip](https://pip.pypa.io/en/stable/installing/)

For application usage with ease

- [Docker](https://docs.docker.com/engine/install/)

AppImage

- Soon...

## Documentation 📕

Build example

```bash
make build -f docker.mk image_name="easy-static"
```

Run command example

```bash
make run -f docker.mk image_name="easy-static" command="start" action="output" environment="dev"
```

## File structure 📁

```
🌳 easy-static/
┣ 📁 ansible/
┃ ┣ 📁 files/
┃ ┃ ┗ 📄 .gitkeep
┃ ┣ 📁 inventory/
┃ ┃ ┗ 📄 .gitkeep
┃ ┣ 📁 playbook/
┃ ┃ ┗ 📄 .gitkeep
┃ ┗ 📄 .gitkeep
┣ 📁 app/
┃ ┗ 📁 Boilerplate/
┣ 📁 design/
┃ ┣ 📄 .gitkeep
┃ ┗ 📄 easy-static-new.png
┣ 📁 docs/
┃ ┗ 📄 .gitkeep
┣ 📁 scripts/
┃ ┣ 📄 .gitkeep
┃ ┣ 📄 install-ansible.sh
┃ ┣ 📄 install-docker.sh
┃ ┣ 📄 install-terraform.sh
┃ ┣ 📄 run.sh
┃ ┗ 📄 s3-action.sh
┣ 📁 terraform/
┃ ┣ 📁 .terraform/
┃ ┃ ┣ 📁 modules/
┃ ┃ ┃ ┗ 📄 modules.json
┃ ┃ ┗ 📁 providers/
┃ ┃ ┗ 📁 registry.terraform.io/
┃ ┃ ┃ ┗ 📁 hashicorp/
┃ ┣ 📁 config/
┃ ┃ ┣ 📄 dev.tfvars
┃ ┃ ┗ 📄 prod.tfvars
┃ ┣ 📁 modules/
┃ ┃ ┗ 📁 s3/
┃ ┃ ┣ 📄 output.tf
┃ ┃ ┣ 📄 provider.tf
┃ ┃ ┣ 📄 resources.tf
┃ ┃ ┗ 📄 variables.tf
┃ ┣ 📄 .gitkeep
┃ ┣ 📄 .terraform.lock.hcl
┃ ┣ 📄 main.tf
┃ ┣ 📄 terraform.tfstate
┃ ┣ 📄 terraform.tfstate.backup
┃ ┗ 📄 versions.tf
┣ 📄 .gitignore
┣ 📄 .gitmodules
┣ 📄 Makefile
┗ 📄 README.md
```

## License 📰

You can check the license at [LICENSE](./LICENSE)