Go to file
Kasper Juul Hermansen d6d98c2ce8 v0.2 (#14)
Co-authored-by: kjuulh <contact@kjuulh.io>
Reviewed-on: #14
2022-09-21 22:55:52 +02:00
_examples v0.2 (#14) 2022-09-21 22:55:52 +02:00
assets v0.2 (#14) 2022-09-21 22:55:52 +02:00
cmd v0.2 (#14) 2022-09-21 22:55:52 +02:00
example Adding Initial action (#1) 2022-09-12 22:12:02 +02:00
integration_test v0.2 (#14) 2022-09-21 22:55:52 +02:00
internal v0.2 (#14) 2022-09-21 22:55:52 +02:00
scripts v0.2 (#14) 2022-09-21 22:55:52 +02:00
templates add-cuddle (#2) 2022-09-12 22:26:32 +02:00
.gitignore v0.1 (#8) 2022-09-18 16:49:34 +02:00
CONFIGURATION_SERVER.md v0.2 (#14) 2022-09-21 22:55:52 +02:00
cuddle.yaml v0.2 (#14) 2022-09-21 22:55:52 +02:00
go.mod v0.2 (#14) 2022-09-21 22:55:52 +02:00
go.sum v0.2 (#14) 2022-09-21 22:55:52 +02:00
LICENSE Add logging 2022-09-10 00:09:09 +02:00
README.md v0.2 (#14) 2022-09-21 22:55:52 +02:00
roadmap.md v0.2 (#14) 2022-09-21 22:55:52 +02:00

Octopush - Your cute action executor

Purpose

The goal of this project is to easily do batch changes or queries on a host of repositories. In large organisations using multi-repository strategies, it may be painful to change even small things across many repositories, because there are so many of them. Octopush aims to change that.

DISCLAIMER: It is still early days, and the api is subject to change.

Features

  • Uses an actions repository, where you store all your pending commands or queries to be performed across your fleet of repositories. (See _examples)
  • Actions can both execute changes, open pull-requests or in some cases commit directly to your preferred branch
    • Actions natively use either shell, go or docker files to execute changes (see _examples/actions)
  • Actions can also be analytical, so you can query your fleet for whatever you would like
  • Works both as a client, or as a server
  • Supports SSH/https for fetching repos
  • Supports GPG signing
  • Supports dry-run mode for easy testing when developing your actions (enabled by default on the cli)

Roadmap

Refer to roadmap.md

Installation

Octopush comes in two modes. Client or Client -> Server. Octopush can stand alone as a client, for smaller and less secure changes. However, for organisations, it may be useful to use Octopush in server mode, which supports more features, and has extra security built in.

Client (CLI)

Download executable from releases

Or Use docker image

docker run --rm kasperhermansen/octopushcli:latest version

Or Build from source

git clone https://github.com/kjuulh/octopush.git
cd octopush

go build cmd/octopush/octopush.go
./octopush version

Or Build with cuddle

git clone https://github.com/kjuulh/octopush.git
cd octopush

cuddle_cli x build_cli

Server

We prefer to run the server directly as a docker image.

docker pull kasperhermansen/octopushserver:latest
docker run -p 9090:80 --rm kasperhermansen/octopushserver:latest

Or Build from source

git clone https://github.com/kjuulh/octopush.git
cd octopush

go build cmd/server/server.go
./server version

Or Build with cuddle

git clone https://github.com/kjuulh/octopush.git
cd octopush

cuddle_cli x build_server

Usage

DISCLAIMER: It is still early days, and the api of the CLI is subject to change, this provides the aim of the project, but as it is currently in flux, there may not be as much handholding in the actual usage.

I will focus on the client here, as the server provides the same features, though available through the cli, but instead as configuration options (see CONFIGURATION_SERVER.md)

Octopush ships with autocomplete built in (courtesy of spf13/cobra). To add:

  • Bash: echo 'source <(octopush completion bash)' >> ~/.bashrc
  • Zsh: echo 'source <(octopush completion zsh)' >> ~/.zshrc

Creating a new action

Creating a new action

git init my-actions # should only be done once
cd my-actions
octopush tmpl init write-a-readme --command
cat write-a-readme/octopush.yml

# Output
# apiVersion: git.front.kjuulh.io/kjuulh/octopush/blob/main/schema/v1
# name: write-a-readme
# select:
#   repositories: []
# actions:
#   - type: shell
#     entry: "main.sh"

Octopush also ships with yaml schema, which should help write the yaml configuration.

Add upstream repositories (victims)

Now add a preferred repository

cat << EOF > write-a-readme/octopush.yml
apiVersion: git.front.kjuulh.io/kjuulh/octopush/blob/main/schema/v1
name: write-a-readme
select:
  providers:                           # new
  - gitea: https://git.front.kjuulh.io # new
    organisation: "kjuulh"             # new
actions:
  - type: shell
    entry: "main.sh"
EOF

This will take all your repositories under an organisation and run the script on.

Another could be to use

cat << EOF > write-a-readme/octopush.yml
apiVersion: git.front.kjuulh.io/kjuulh/octopush/blob/main/schema/v1
name: write-a-readme
select:
  repositories:                                       #new
    - git@git.front.kjuulh.io:kjuulh/octopush.git       #new
    - git@git.front.kjuulh.io:kjuulh/octopush-test.git  #new
actions:
  - type: shell
    entry: "main.sh"
EOF

This will just apply to those repositories instead. Both can also be combined for a shared effect.

Execute action

To run the script use

octopush process --path "write-a-readme"

This will cause the octopush process to automatically apply the action on the repo and open a pr.

Query repositories

Octopush can also be used to query.

cat << EOF > write-a-readme/octopush.yml
apiVersion: git.front.kjuulh.io/kjuulh/octopush/blob/main/schema/v1
name: write-a-readme
select:
  repositories:
    - git@git.front.kjuulh.io:kjuulh/octopush.git
    - git@git.front.kjuulh.io:kjuulh/octopush-test.git
queries:
  - type: grep
    query: "# README"
EOF

Using the same command as above, will return the lines on each repo with those criteria. Everything is run in docker, even locally, so no need to install fancy tools.

Do note: All actions will be run as dry-run unless --apply is added. This is to help test locally, as well as not cause serious issues. The server configuration is pretty much the same, except the command would look like so: octopush server process --path "write-a-readme" --apply. Octopush will try to infer as much as possible, but it may be needed to apply some extra flags to specify upstream repositories and such. Octopush will also help you setup keys and such on the first run, using octopush setup or octopush server setup.

Contributing

It is still early days, and as such things are moving fast, I may not be able to implement features, because I am focusing my energy on the API. That said PRs are welcome, though they are at your own risk.

Bugs & features requests

Please use issues

Development

We use cuddle to improve ease of use, it is however, not a requirement, and probably won't need to be used outside core maintainers.

Simply:

go run cmd/octopush/octopush.go # CLI
go run cmd/server/server.go # Server

We follow the gofmt formatting, along with optionally but recommend golines

If using cuddle

cuddle_cli x run # Run both server and client, will do a quick test sweep on the cli
cuddle_cli x watch_run # Automatically refresh both
cuddle_cli x fmt # will format the current code