credits for houda maabrouk for the logo: https://www.linkedin.com/in/maabrouk-houda-065748202/
This project is an experiment of my knowledge, I'd be happy if anyone find it useful.
Fissaa is a CLI that helped me deploy applications to AWS ECS without the headache of setting-up domain registration,TLS Certification, Load Balancing,Rolling Back and budget monitoring.
Fissaa is a Tunisian word meaning speed-up.
The policies may seem too open for some developers, but I didn't focus so much on giving just the required permission for each service.
you can open a pull request if you find it a problem and I will solve it.
Note: to add those policies you need root account.
- AWSCertificateManagerFullAccess
- AmazonECS_FullAccess
- AmazonRoute53FullAccess
- AmazonS3FullAccess
- CloudFrontFullAccess
- AmazonRDSFullAccess
- AmazonEC2FullAccess
- IAMUserChangePassword
- AWSCloudFormationFullAccess
here is a link for a list of custom permissions you need to add for you user
https://gist.github.com/hamzabouissi/f800a962502c43c1bcff1bee0be3c5db
you need to register a domain, if the domain registrar is AWS Route53 it be easy, but in case of any other registrar you need to crate hosted zone with the CLI.
Note: I used to register my domain on NameCheap and route with custom dns to Route53 name servers.
Fissaa is currently available on Linux and Windows.
Fissaa use heavily Docker to build,push images of your applications.
your project folder must contain a Dockerfile and the project is running on port 80.
Installing is easy as running 2 commands:
wget https://fissaa-cli.s3.amazonaws.com/test/install.sh -o install.shsudo sh install.sh linuxCongratulation, Fissaa is ready.
Before deploying your application, you need to initialize your AWS creedentials on your projcet folder
to do this you can run the following command:
fissaa env
USAGE:
fissaa env [OPTIONS] <COMMAND>
OPTIONS:
-h, --help Prints help information
COMMANDS:
init <aws-secret-key> <aws-access-key>Note: be sure this AWS credentials belongs to an user who have the required policies.
Fissaa provide a simple one command to deploy your containerized application:
fissaa infrastructure yourdomain.com deploy --help
USAGE:
fissaa infrastructure deploy [OPTIONS]
OPTIONS:
-h, --help Prints help information
--environment Environment are: Dev, Prod
--add-monitor Add AWS X-Ray to track your user requests
--dockerfile-path 
updating your deployed application is the same way as deploying it, you just run the same command and it will update your code
fissaa infrastructure yourdomain.com deployFissaa can integrate a monitoring service(AWS X-Ray) with your deployed application, you need to integrate AWS X-RAY sdk first in your application code.
to deploy and add monitoring, you can run the following command:
fissaa infrastructure yourdomain.com deploy --add-monitor
you can see your application logs by running the following command :
fissaa infrastructure yourdomain.com logs --help
USAGE:
fissaa infrastructure logs [OPTIONS]
OPTIONS:
-h, --help Prints help information
--start-date format yyyy/MM/dd HH:mm:ss
--hour hour must be between 0 and 5
fissaa infrastructure yourdomain.com add-alarm --email <email>You will receive a subscription request on email, after accepting it, if your server hit 10 5xx request within 5 minute you will get an email like this one.
fissaa infrastructure yourdomain.com rollback list-image-tags --help
USAGE:
fissaa infrastructure rollback list-image-tags [OPTIONS]
OPTIONS:
-h, --help Prints help informationfissaa infrastructure yourdomain.com rollback apply --help
USAGE:
fissaa infrastructure rollback apply [OPTIONS]
OPTIONS:
-h, --help Prints help information
--latest rollback to version prior to the current version, if
no version nothing happen
--image-version Image version for container registryIf you want to keep track your budget and get notified when you exceed it, you can create an alarm using the following command:
fissaa budget <domain> create <budget-amount> <budget-amount-limit> <email>To list your application cost on a day to day basis, you can see with the following command:
fissaa budget <domain> cost-list
I created a simple template for sake of simplicity, but I want to create more templates for different cases like :
- ML
- Gaming
- IOT
- ECommerce
One of the case I got while developing this CLI is I wanted to deploy a Ghost Platform without the headache of setting-up all the prerequisite that ghost need like (RDS, S3, Email Server).
So I created a simple command that can deploy ghost under your specific domain:
fissaa template use --help
USAGE:
fissaa template use <template-name> <mail-provider> <mail-email>
<mail-password> [OPTIONS]
ARGUMENTS:
<template-name> template name, available options are: ghost
<mail-provider> mailing service, available options are: sendinblue
<mail-email>
<mail-password>
OPTIONS:
-h, --help Prints help information
to initialize a database, you can run the following command:
Note: database is available to connect to from a deployed application.
fissaa storage db init --help
USAGE:
fissaa storage db init <db-type> <db-username> <db-name> <db-password> [OPTIONS]
ARGUMENTS:
<db-type> different db type allowed values are: mysql, mariadb, postgres
<db-username>
<db-name>
<db-password>
OPTIONS:
-h, --help Prints help information
--db-storage your database size on GB minumum: 20G/image
fissaa storage s3 --help
USAGE:
fissaa storage s3 [OPTIONS] <COMMAND>
OPTIONS:
-h, --help Prints help information
COMMANDS:
init <bucket-name>if you're using a custom domain registrar, run the following to create Route53 hosted zone then copy paste the name server into your domain registrar custom dns .
here is an example: https://www.namecheap.com/support/knowledgebase/article.aspx/767/10/how-to-change-dns-for-a-domain/
fissaa domain <domain-name> create if you have a domain and want to add a TLS Certification to it, you can just run following command
Note: domain must be registered on Route53 as Hosted Zone
fissaa domain <domain-name> add-https