How to create an heptapod instance
Once the wiki is functional, add a page explaining how to create an heptapod instance. This page should contain the following information:
Prepare your environment
1. Example configuration
This steps of instructions were tested on a plain debian:jessie
docker container, which was run like this:
docker run --rm -ti \
--name heptapod-builder -h heptapod-builder \
-v /var/run/docker.sock:/var/run/docker.sock \
-e DOCKER_GID=$(getent group docker | cut -d: -f3) \
debian:jessie
You should adapt the commands in the following sections according to your own system.
2. Install the tools
Some packages are needed, and you may already have them:
apt-get update
apt-get install -y \
apt-transport-https \
ca-certificates \
curl \
gnupg2 \
python-dev \
python-pip \
software-properties-common
If you don't have a docker installation, follow these steps:
curl -fsSL https://download.docker.com/linux/debian/gpg \
| apt-key add -
add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/debian jessie stable"
apt-get update
apt-get install -y \
docker-ce
Install mercurial and the evolve extension
pip install \
hg-evolve \
Mercurial
Install heptapod
heptapod
branch of the heptapod/omnibus
project
1. Clone the hg clone -b heptapod https://heptapod.octobus.net/heptapod/omnibus
2. Build and run the docker image
cd omnibus
docker build heptapod_docker -t heptapod
docker run --detach \
--hostname heptapod.example.com \
--name heptapod \
heptapod
This command echoes the URL to connect to to access the GitLab instance.
echo "http://$(docker inspect \
-f '{{.NetworkSettings.Networks.bridge.IPAddress}}' heptapod)/"