alexhouse / docker-satis

Docker Satis

Docker Satis

A docker image and configuration to run Satis very easily in seconds.

DO NOT forget to create a config.json file compatible with satis in your directory before starting the docker container.

Run the container

docker run -p 80:80 \
  -v $(pwd):/app \
  -v "${HOME}/.ssh/id_rsa":/var/tmp/id \
  -v /var/tmp/composer:/root/.composer \
  -e PRIVATE_REPO_DOMAIN_LIST=toto.tata.tutu.com \
  -e CRONTAB_FREQUENCY="*/10 * * * *" \
  -d ypereirareis/docker-satis:latest

Crontab

By default, building script is executed every minute thanks to the crontab configuration

* * * * * root /satis/build.sh >> /var/log/satis-cron.log 2>&1

You can override this value with an ENV variable:

-e CRONTAB_FREQUENCY="*/10 * * * *"

Or you can disable cron with this ENV variable value:

-e CRONTAB_FREQUENCY="-1" or -e CRONTAB_FREQUENCY=-1

SSH key

The container needs to know the ssh key you aded in your private repo.

-v "${HOME}/.ssh/id_rsa":/var/tmp/id

The ssh fingerprint of the private repos servers need to be added in the known_hosts file inside the container that's why we specify the URL through ENV variable.

-e PRIVATE_REPO_DOMAIN_LIST=foo.example.com bar.exemple.com baz.exemple.com

Composer cache

Cache must be shared with the host to be reused when you restart the container.

-v /var/tmp/composer:/root/.composer

Satis Home page

http://127.0.0.1 (but you can map another port)

Satisfy

Satisfy allows you to add repositories in your satis configuration file with a web interface.

Once the container is started, just go to:

http://127.0.0.1/admin

Access Satis from outside

If you want to give access satis to the outside world, you should use a reverse proxy.

Below is a working setup for Nginx:

server {
    server_name satis.domain.tld;

    location / {
        proxy_pass http://127.0.0.1:80;
    }
}

Or have a look at: https://github.com/jwilder/nginx-proxy

And run these two containers:

 docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock jwilder/nginx-proxy

then

docker run -p 8080:80 \
  -v $(pwd):/app \
  -v "${HOME}/.ssh/id_rsa":/var/tmp/id \
  -v /var/tmp/composer:/root/.composer \
  -e PRIVATE_REPO_DOMAIN_LIST=foo.example.com \
  -e CRONTAB_FREQUENCY="*/5 * * * *" \
  -e VIRTUAL_HOST="satisfy.local.dev" \
  ypereirareis/docker-satis:latest

and you will access the Satisfy web page through:

http://satisfy.local.dev/