Skip to main content

Easier Docker based deployments to AWS.

Project description

# fuku

Fuku is a (young) system to help manage web application infrastructure using AWS. It’s aim is to replicate some of the simplicity of Heroku without the cost.

## Requirements:

Please install the following requirements prior to installing Fuku:

  • Python 3.6

  • ssh

  • ssh-agent

  • gpg

  • psql

  • awscli

## Installation

Standard pip install:

`bash pip install fuku `

## Quickstart for new configurations

  1. Configure your AWS credentials as usual (aws configure).

  2. fuku profile ls to see available profiles.

    fuku profile mk <name> to make the AWS groups etc required.

  3. fuku profile bucket <bucket> to set a workspace for Fuku.

  4. fuku region ls to see available regions.

    fuku region sl <region> to select a region.

  5. fuku cluster mk <name> to create a cluster.

## Quickstart for existing configurations

  1. Configure your AWS credentials as usual (aws configure).

  2. fuku profile ls to see available profiles.

    fuku profile sl <name> to select your profile.

  3. fuku profile bucket <bucket> to set a workspace for Fuku.

  4. fuku region ls to see available regions.

    fuku region sl <region> to select a region.

  5. fuku cluster ls to see available clusters.

    fuku cluster sl <cluster> to select a cluster.

    Enter password to access cluster key file.

  6. fuku app ls to see available apps.

    fuku app sl <app> to select an app.

  7. fuku pg ls to see available DBs.

    fuku pg sl <db> to select a DB.

    Enter password to access PGPASS file.

At this point you have configured your session for a particular cluster, application, and database. For convenience it’s best to cache the session for easy retrieval:

fuku session sv <name>

fuku session ld <name>

## Downloading current DB

To download the current database:

fuku pg dump <dumpfile>

## Upload DB

To overwrite a database with new content (CAUTION):

fuku pg restore <filename>

## SSH into a node

To access one of the nodes in the cluster directly:

fuku node ssh <name>

## Run an arbitrary command

To run a command:

fuku service run <task> <command>

This attaches to a running container from the specified task, then runs the provided command.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fuku-0.0.21.tar.gz (43.3 kB view details)

Uploaded Source

Built Distribution

fuku-0.0.21-py3.6.egg (123.4 kB view details)

Uploaded Source

File details

Details for the file fuku-0.0.21.tar.gz.

File metadata

  • Download URL: fuku-0.0.21.tar.gz
  • Upload date:
  • Size: 43.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for fuku-0.0.21.tar.gz
Algorithm Hash digest
SHA256 7a2e21ebf82fe29343abf81bb30ef9a685b9a6169edbd5b00600f539028e87e3
MD5 bc075b1b0ebbe310b7d25013ade92275
BLAKE2b-256 ad7c066516cde20e9c07e05ca38a1e0fe5c70a9132aaecdd1df1b32519c81c84

See more details on using hashes here.

File details

Details for the file fuku-0.0.21-py3.6.egg.

File metadata

  • Download URL: fuku-0.0.21-py3.6.egg
  • Upload date:
  • Size: 123.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for fuku-0.0.21-py3.6.egg
Algorithm Hash digest
SHA256 9a5ed6dc7b72bf8485223f41ea949dc35e1101c32eff95b5acb6f69bcecb04b3
MD5 feb55d6d897e7d1acfe4eb76419e9735
BLAKE2b-256 71fc777e9ef9cdd71af090ba37afdba2b0d4a7ecffb465fb6c2095abac5082ae

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page