1 file was added to this release more than 14 days after its initial publication. Inspect the release files before installing.
# fuku [](https://badge.fury.io/py/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
Configure your AWS credentials as usual (aws configure).
fuku profile ls to see available profiles.
[optional] If you need multiple AWS profiles, create a new profile by editing the file ~/.aws/credentials and copying the default lines.
fuku profile sl <profile> to select the active AWS profile for Fuku.
fuku profile bucket <bucket> to set a workspace for Fuku.
fuku region ls to see available regions.
fuku region sl <region> to select a region.
fuku cluster mk <name> to create a cluster.
## Quickstart for existing configurations
Configure your AWS credentials as usual (aws configure).
fuku profile ls to see available profiles.
fuku profile sl <name> to select your profile.
fuku profile bucket <bucket> to set a workspace for Fuku.
fuku region ls to see available regions.
fuku region sl <region> to select a region.
fuku cluster ls to see available clusters.
fuku cluster sl <cluster> to select a cluster.
Enter password to access cluster key file.
fuku app ls to see available apps.
fuku app sl <app> to select an app.
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> <dump_path>
## 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.
## Logging
To control logs printed use the flag –log, it uses the available logging levels (CRITICAL, WARNING, INFO, DEBUG)
fuku –log=DEBUG <command>
By default the logs are set to WARNING.
## Running fuku in Sub-processes
The default behaviour is to assume that one user is on a single app and/or DB instance at all time.
However if you need to spawn multiple processes running commands on different app and/or DB instance, you can use the –app or –db flags.
For example, we can run in parallel:
fuku –app=first_app service wait bg; fuku –app=first_app service run bg “./manage.py migrate”;
fuku –app=second_app service wait bg; fuku –app=second_app service run bg “./manage.py migrate”;
3 maintainers
Metadata
3 maintainers
Release files for fuku 0.0.32
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
File added late
1 file was uploaded more than 14 days after the first file in this release.
While project maintainers occasionally add legitimate files to an existing release, late additions can also indicate a security compromise.
We recommend inspecting the release files before installing.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fuku-0.0.32.tar.gz | 41.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fuku-0.0.32-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 96.3 kB
Release files / fuku-0.0.32.tar.gz
| Download URL | fuku-0.0.32.tar.gz |
|---|---|
| Size | 41.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bed886d02655713b51582c781691e2b40ed3afcc730eb90bd3e4455e27e371af
|
|
BLAKE2b-256 checksum How to use checksums |
2bff2b3e27cd5be3559bee791cd6913b8aa437a152e88b150a676256f752a673
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / fuku-0.0.32-py3-none-any.whl
File added late
This file was uploaded more than 14 days after the first file in this release.
While project maintainers occasionally add legitimate files to an existing release, late additions can also indicate a security compromise.
We recommend inspecting the release file before installing.
| Download URL | fuku-0.0.32-py3-none-any.whl |
|---|---|
| Size | 54.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb9575b53522bcda7539e9e2481fa84831d9b74b1e322a7cfa2a168a544e1e48
|
|
BLAKE2b-256 checksum How to use checksums |
fb0ecdf5e0694b21510b41eaeb62bafd7c672d8cbae951fac6e2c6179fb0940b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
](https://badge.fury.io/py/fuku){kind=link}