wakeci

What is it?

wakeci is an automation tool which helps to execute repetitive tasks

Features

• simple job configuration using YAML
• easy to install - just download a binary file from Releases
• automatic Let's Encrypt SSL certificates
• parameterized builds, artifacts, intervals and timeouts - see job configuration example below
• no plugins, no extensive configuration - focus on your project instead!

Job configuration example

See full description here

desc: Build and release wake application
params:
  - VERSION: master

tasks:
  - name: Clone repository
    run: git clone [email protected]:jsnjack/wakeci.git --recursive

  - name: Checkout version
    run: sh ${WAKE_CONFIG_DIR}utils/checkout.sh wakeci ${VERSION}

  - name: Install npm dependencies
    run: cd wakeci/src/frontend && npm install

  - name: Build application
    run: cd wakeci && make build

  - name: Create a release on github
    run: python ${WAKE_CONFIG_DIR}utils/release_on_github.py -f wakeci/bin/wakeci -r jsnjack/wakeci -t "v`cd wakeci && monova`"

timeout: 10m

on_failed:
  - name: Send notification to Slack
    run: >-
      python ${WAKE_CONFIG_DIR}utils/notify_slack.py
      -t "Job ${WAKE_JOB_NAME} has failed <${WAKE_URL}build/${WAKE_BUILD_ID}|#${WAKE_BUILD_ID}>"
      -k error

on_finished:
  - name: Send notification to Slack
    run: >-
      python ${WAKE_CONFIG_DIR}utils/notify_slack.py
      -t "New wake version `cd wakeci && monova` <${WAKE_URL}build/${WAKE_BUILD_ID}|#${WAKE_BUILD_ID}>"
      -k ok

How to use it?

Usage of ./bin/wakeci:
  -config string
    	Configuration file location (default "Wakefile.yaml")

Wakefile.yaml format

# Port to start the server on (default "8081")
port: 8081
# Hostname for autocert. Active only when port is 443
hostname: ""
# Working directory (default ".wakeci/")
workdir: ./wakeci
# Configuration directory - all your job files (default "./")
jobdir: ./

Default password is admin. Don't forget to immediately change it!

API documentation

See full description here

Development

Requires golang 1.16+

How to install golang 1.16+

go get golang.org/dl/go1.16.2
/home/$USER/go/bin/go1.16.2 download
# Manage different versions with `alternatives`
sudo alternatives --install /usr/bin/go go /home/$USERNAME/go/bin/go1.16.2 10
# Switch between different go versions
sudo alternatives --config go

Golang downloads page https://golang.org/dl/

Install dependencies

sudo dnf install entr
go install github.com/swaggo/swag/cmd/swag@latest

# cd src/frontend
npm install

Start application

# frontend
make runf

# backend
make runb