Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cslant/blog-runner

This repo is to set up the runner for updating the blog at https://cslant.com/blog
https://github.com/cslant/blog-runner

blog cslant cslant-blog cslant-cicd cslant-github cslant-runner deploy runner

Last synced: 14 days ago
JSON representation

This repo is to set up the runner for updating the blog at https://cslant.com/blog

Awesome Lists containing this project

README

        

# CSlant Blog Runner

```text
██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗███╗ ██╗███╗ ██╗███████╗██████╗
██╔══██╗██║ ██╔═══██╗██╔════╝ ██╔══██╗██║ ██║████╗ ██║████╗ ██║██╔════╝██╔══██╗
██████╔╝██║ ██║ ██║██║ ███╗ ██████╔╝██║ ██║██╔██╗ ██║██╔██╗ ██║█████╗ ██████╔╝
██╔══██╗██║ ██║ ██║██║ ██║ ██╔══██╗██║ ██║██║╚██╗██║██║╚██╗██║██╔══╝ ██╔══██╗
██████╔╝███████╗╚██████╔╝╚██████╔╝ ██║ ██║╚██████╔╝██║ ╚████║██║ ╚████║███████╗██║ ██║
╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝
```

This repo is to set up the runner for updating the blog at https://cslant.com/blog

We can use this runner to update the Blog automatically with CI/CD pipelines.

## Installation

First, copy the `.env.example` file to `.env` and update the values.

```bash
envsubst < .env.example > .env
```

If you don't have `envsubst` command, you can use the following command:

```bash
cp .env.example .env
```

In the `.env` file, update the values to match your environment.

```bash
# .env

#SOURCE_DIR=~/source
SOURCE_DIR=/home/user/cslant.com/blog

[email protected]:cslant

# The name of the runner
WORKER_NAME="CSlant Blog"

# add the env to choose "npm" or "yarn" as the installer
INSTALLER=yarn

# App Config
# E.g: prod, dev
ENV=prod

NODE_VERSION=22

USE_SUBMODULES=false
```

> [!IMPORTANT]
> ## Command can't be used if wrong values are set in the `.env` file.
> * If the `SOURCE_DIR` is wrong, the runner will not be able to find the source code. So, please make sure the `SOURCE_DIR` is correct.

Then, you can just run the following command to start the runner.

```bash
./runner.sh a
```

## Usage

The runner has the following commands:

| Command | Description |
|---------------------|------------------------------------------|
| `help`, `tips` | Shows the help message |
| `build`, `b` | Builds the Blog |
| `worker`, `w` | Create or restart the worker |
| `sync`, `blog_sync` | Sync the Blog with the remote repository |
| `all`, `a` | Runs all the commands |