Wolkstack

Table of Contents

• About the Repo
• Getting Started
• Code Structure
• Architecture
• Tech
• Contributors
• License

About the Repo

This repo shows the development state of the Wolkstack project, a cloud development framework for

Despite being available on github, this repository is intended as a read-only resource and has been licensed as such. Permissions are not given to use or modify this software.

Getting Started

Wolkstack requires several steps and infrastructure pieces to be setup for optimal usage, the exact steps to install the below software will not be included in this documentation, although tutorials can be found on the provided pages.

Required programs:

• KubeCTL
• AWS CLI
• Terraform
• Helm
• Python

With this complete some pre-steps are required to ensure that credentials are generated in your project.

AWS CLI

Ensure that you have run aws configure and set your authentication credentials locally in your computer

Environment Credentials

Terraform requires some basic credentials to run CI/CD services on your AWS account, the exact commands to set these are shown below.

This code makes use of environment variables to ensure that the user does not expost information, additionally credentials are encrypted and made use of with AWS parameter store, a secure repository for this use case.

Docker-Hub

To deploy containers and install applications we need a docker-hub credential which can be set with:

export TF_VAR_docker_hub_password={password}

Github

To setup web-hooks and access code for CI/CD on your private repositories, how to get the token:

export TF_VAR_github_token={token}

Install

Wolkstack is available as a simple PyPi package and can be installed with command pip install Wolkstack

Once installed steps and commands can be followed inside the Wolkstack CLI.

Code Structure

Explained here are the most important points of the code structure, where to find configs, etc.

tbd

Architecture

An full example wolkstack deployment is shown here.

Tech

Wolkstack sets you up with a standard set of tools that can be switched and replaced as desired, a list of used technology can be seen here.

Automated Deployments

• Terraform
• Helm
• Docker
• KubeCTL

Cluster Tools

• External-DNS
• Cert-Manager
• Nginx-Ingress

Continuous Deployment / Continous Integration

• AWS Codebuild
• AWS Codepipeline
• Docker Hub

Service setup:

Frontend

• Node
• React.js

Backend:

• Node
• Express

Database:

• PostgreSQL

Contributors

• Josh Gorman
  • Github
  • Website

License

Copyright 2020 Josh Gorman

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.