Getting started - Worker application (original) (raw)

Yokai provides a ready to use worker application template to start your worker projects.

Overview

The worker application template provides:

• a ready to extend Yokai application, with the worker module installed
• a ready to use dev environment, based on Air (for live reloading)
• a ready to use Dockerfile for production
• some examples of worker and test to get started

Layout

This template is following the recommended project layout:

• cmd/: entry points
• configs/: configuration files
• internal/:
  • worker/: worker and test examples
  • bootstrap.go: bootstrap
  • register.go: dependencies registration

Makefile

This template provides a Makefile:

[](#%5F%5Fcodelineno-0-1)make up # start the docker compose stack [](#%5F%5Fcodelineno-0-2)make down # stop the docker compose stack [](#%5F%5Fcodelineno-0-3)make logs # stream the docker compose stack logs [](#%5F%5Fcodelineno-0-4)make fresh # refresh the docker compose stack [](#%5F%5Fcodelineno-0-5)make test # run tests [](#%5F%5Fcodelineno-0-6)make lint # run linter

Installation

With GitHub

You can create your repository using the GitHub template.

It will automatically rename your project resources, this operation can take a few minutes.

Once ready, after cloning and going into your repository, simply run:

With gonew

You can install gonew, and simply run:

[](#%5F%5Fcodelineno-2-1)gonew github.com/ankorstore/yokai-worker-template github.com/foo/bar [](#%5F%5Fcodelineno-2-2)cd bar [](#%5F%5Fcodelineno-2-3)make fresh

Usage

Once ready, the application core dashboard will be available on http://localhost:8081.

To see the provided example worker in action, simply run:

Going further

To go further, you can:

• check the worker module documentation to learn more about its features
• follow the worker application tutorial to create, step by step, a worker application
• test the worker demo application to see all this in action