Table of Contents

• About
• Prerequisite
  • Tools
  • Third party tools
• Installation
  • Download from dockerhub
  • Build from chiselapp (fossil)
  • Build from github
• Configuration options
  • General options
  • Timezone
• Continues Integration
• Troubleshooting
  • Log output
  • Shell access

About

This is ubuntu base docker image (version 22.04) using s6-overlay.

Ubuntu-s6 is self-hosting at https://chiselapp.com/user/oupfiz5/repository/ubuntu-s6.

If you are reading this on GitHub, then you are looking at a Git mirror of the self-hosting Ubuntu-s6 repository. The purpose of that mirror is to test and exercise Fossil's ability to export a Git mirror and using Github CI/CD (Github Actions). Nobody much uses the GitHub mirror, except to verify that the mirror logic works. If you want to know more about Ubuntu-s6, visit the official self-hosting site linked above.

Prerequisite

Tools

1. *nix operation system
2. Install Docker
3. Install git (optional)
4. Install fossil (optional)

Third party tools

They are using for testing and scanning:

1. Bats
2. Shellcheck
3. Hadolynt
4. Dockle
5. Snyk - not necessarily
6. Trivy - not necessarily

Installation

Download from dockerhub

docker pull oupfiz5/ubuntu-s6:22.04-3.1.4.2

Build from chiselapp (fossil)

fossil clone https://chiselapp.com/user/oupfiz5/repository/ubuntu-s6 ubuntu-s6.fossil
mkdir ubuntu-s6
cd ubuntu-s6
fossil open ../ubuntu-s6.fossil
docker build -t oupfiz5/ubuntu-s6 .

Build from github

git clone https://github.com/oupfiz5/ubuntu-s6.git
cd ubuntu-s6
docker build -t oupfiz5/ubuntu-s6 .

Configuration options

General options

Option	Default	Description
TZ	UTC	Set timezone, example Europe/Moscow

Timezone

Set the timezone for the container, defaults to UTC. To set the timezone set the desired timezone with the variable TZ.

docker run -itd --restart always \
           --name ubuntu-s6  \
           --env 'TZ=Europe/Moscow' \
           oupfiz5/ubuntu-s6:22.04-3.1.4.2

Continues Integration

For build and push docker images we use Github Actions workflow. Flow process is GitHub flow.

Troubleshooting

Log output

For debugging and maintenance purposes you may want access the output log. If you are using Docker version 1.3.0 or higher you can access a running containers shell by starting bash using docker interactive:

docker run -it --rm \
       --name=ubuntu-s6 \
       oupfiz5/ubuntu-s6:22.04-3.1.4.2

Shell access

For debugging and maintenance purposes you may want access the containers shell. If you are using Docker version 1.3.0 or higher you can access a running containers shell by starting bash using docker exec:

docker exec -it ubuntu-s6 /bin/bash