zd333 / electro_bot

electro_bot

Pet project to track information about electricity outages.

Prerequisites

• install NodeJS, nvm, flyctl
• nvm use
• npm ci
• see https://fly.io/docs
• create fly apps with electrobot and electrobotstg names
• crate pg-electro-bot and pg-electro-bot-stg fly Postgres clusters for prod and stg envs
• attach apps to corresponding Postgres clusters
• set secrests for prod and stg envs (see apps/electro-bot/.env.example)

Run in local dev env mode

• set values in apps/electro-bot/.env (see apps/electro-bot/.env.example and fly.toml)
• npm start

Migrations

• npm run migrate:electro-bot to apply migrations
• npx knex migrate:make some_migration_name to create new migration

Connect to remote Postgre

Staging: flyctl proxy 5433 -a pg-electro-bot-stg, production: flyctl proxy 5433 -a pg-electro-bot.

Deploy

TODO: this is tmp solution that causes downtime during deployment, come up with normal flow.

!Always deploy staging env first (this minimizes prod downtime since all images are already built).

Staging:

• flyctl --config fly.stg.toml scale count 0
• flyctl --config fly.stg.toml deploy
• flyctl --config fly.stg.toml scale count 1

Production:

• flyctl scale count 0
• flyctl deploy
• flyctl scale count 1

Restart

Staging: flyctl apps restart electrobotstg, production: flyctl apps restart electrobot.

Logs

Staging: flyctl --config fly.stg.toml logs, production: flyctl logs.

Recreate builder

Do this when no space left on builder device:

• flyctl apps list | grep builder
• flyctl apps destroy <name>

Generate HTML docs

• npm run gendoc