Skip to content

Latest commit

 

History

History
74 lines (54 loc) · 3.39 KB

README.md

File metadata and controls

74 lines (54 loc) · 3.39 KB

grid3_taiga

get Taiga up and running in on grid3 VM

what in this image

  • Taiga on Ubuntu 20.04
  • include preinstalled openssh-client, openssh-server, curl, docker and docker-compose.
  • ufw with restricted rules applied.
  • zinit process manager which is configured with these services:
    • sshd: starting OpenSSH server daemon
    • contained: starting containerd daemon, which manages the complete docker containers lifecycle.
    • dockerd: starting the Docker daemon.
    • taiga: Define different taiga services/containers, and spin everything up.
    • sshd-init: Add the user SSH key to authorized_keys, so he can log in remotely to the host which running this image.
    • ufw-init: define restricted firewall/iptables rules.
    • ufw: apply the pre-defined firewall rules
    • superuser-init: create the superuser based on en vars as soon as the taiga is up and running

Building

in the grid3_taiga directory

docker build -t {user|org}/grid3_taiga_docker:latest .

Deploying on grid 3

convert the docker image to Zero-OS flist

Easiest way to convert the docker image to Flist is using Docker Hub Converter tool, make sure you already built and pushed the docker image to docker hub before using this tool.

Deploying

Easiest way to deploy a VM using the flist is to head to to our playground and deploy a Virtual Machine by providing this flist URL.

  • make sure to provide the correct entrypoint, and required env vars.
  • another important perquisite is to have a disk mounted on /var/lib/docker. make sure its size is big enough to fit both the images for taiga, and the volumes which will store all the db and the media files, etc.

or use the dedicated Taiga weblet if available, which will deploy an instance that satisfies the above perquisites.

another way you could use is using our terraform plugin docs

here you can find a full terraform file example to deploy this flist on grid3 link

Flist

URL:

TODO: should be updated to official repo.

https://hub.grid.tf/samehabouelsaad.3bot/abouelsaad-grid3_taiga_docker-latest.flist

Entrypoint

  • /sbin/zinit init

Required Env Vars

  • SSH_KEY: User SSH public key.
  • DOMAIN_NAME: the domain name, eg: grid3taiga.gent01.dev.grid.tf

Optional Env Vars (but some functionality won't be available if these env vars doesn't set)

superuser account (Admin)

  • ADMIN_USERNAME: user name to access the admin dashboard on {doamin name}/admin/.
  • ADMIN_PASSWORD: the admin password for admin dashboard.
  • ADMIN_EMAIL: email address for admin user.

smtp server settings

caution: configure smtp settings bellow only If you have an working smtp service and you know what you’re doing. otherwise don't set thoses or leave these settings empty. set wrong smtp settings will cause issues/server errors in taiga.

  • DEFAULT_FROM_EMAIL: the from email shown when sent emails to taiga members.
  • EMAIL_USE_TLS: either "True" or "False".
  • EMAIL_USE_SSL: either "True" or "False".
  • EMAIL_HOST: eg, "smtp.gmail.com".
  • EMAIL_PORT: smtp server port.
  • EMAIL_HOST_USER: the account address to sent the emails from.
  • EMAIL_HOST_PASSWORD: the account password.