Déployer une instance Mastodon sur Docker

Mastodon est un réseau social de micro-blogging libre et décentralisé. Il est une bonne alternative à Twitter. Voici comment tester un peu ses possibilités.

Prérequis

Avoir installé Docker.

Installation

Pour faire simple (bien que brutal) cloner le dépôt Github du projet.

$ git clone https://github.com/tootsuite/mastodon.git

1	$ git clone https://github.com/tootsuite/mastodon.git

Ensuite copier et éditer le fichier de configuration.

$ cp .env.production.sample .env.production

1	$ cp .env.production.sample .env.production

L’éditer et remplir les champs suivants :

LOCAL_DOMAIN=</code> # d'abord remplis avec localhost j'ai ensuite laissé vide parce que mon instance est locale (pour mes tests)
LOCAL_HTTPS=false # true si certificat

1 2	LOCAL_DOMAIN=</code> # d'abord remplis avec localhost j'ai ensuite laissé vide parce que mon instance est locale (pour mes tests) LOCAL_HTTPS=false # true si certificat

Pour la configuration SMTP utiliser Mailgun ou tout autre serveur SMTP.

SMTP_SERVER=smtp.mailgun.org
SMTP_PORT=587
SMTP_LOGIN=toto
SMTP_PASSWORD=1234
SMTP_FROM_ADDRESS=notifications@example.com
<strong>SMTP_DOMAIN=example.com</strong>

SMTP_SERVER=smtp.mailgun.org

SMTP_PORT=587

SMTP_LOGIN=toto

SMTP_PASSWORD=1234

SMTP_FROM_ADDRESS=notifications@example.com

SMTP_DOMAIN=example.com

Ajouter l’option SMTP_DOMAIN ce qui vous évitera des heures de recherches.

Lancer ensuite un build

docker-compose build

1	docker-compose build

Puis générer la clé secrète

docker-compose run --rm web rake secret

1	docker-compose run --rm web rake secret

Si tout ce passe bien recopier la clé dans le fichier .env.production

Créer la base de données

docker-compose run --rm web rails db:migrate

1 2	docker-compose run --rm web rails db:migrate

Et compiler les assets

docker-compose run --rm web rails assets:precompile

1 2	docker-compose run --rm web rails assets:precompile

Vous pouver lancer le monstre :

docker-compose up

1 2	docker-compose up

Ou en mode démon :

docker-compose up -d

1 2	docker-compose up -d

Connectez vous sur le port 3000 : http://localhost:3000

Exemple Configuration

# Service dependencies
REDIS_HOST=redis
REDIS_PORT=6379
DB_HOST=db
DB_USER=postgres
DB_NAME=postgres
DB_PASS=
DB_PORT=5432

# Federation
LOCAL_DOMAIN=
LOCAL_HTTPS=false



# Application secrets
# Generate each with the `rake secret` task (`docker-compose run --rm web rake secret` if you use docker compose)
PAPERCLIP_SECRET=
SECRET_KEY_BASE=<secret>
OTP_SECRET=

# Registrations
# Single user mode will disable registrations and redirect frontpage to the first profile
# SINGLE_USER_MODE=true
# Prevent registrations with following e-mail domains
# EMAIL_DOMAIN_BLACKLIST=example1.com|example2.de|etc
# Only allow registrations with the following e-mail domains
# EMAIL_DOMAIN_WHITELIST=example1.com|example2.de|etc

# Optionally change default language
DEFAULT_LOCALE=fr

# E-mail configuration
# Note: Mailgun and SparkPost (https://sparkpo.st/smtp) each have good free tiers
SMTP_SERVER=smtp.mailgun.org
SMTP_PORT=587
SMTP_LOGIN=
SMTP_PASSWORD=
SMTP_FROM_ADDRESS=notifications@example.com
#SMTP_DELIVERY_METHOD=smtp # delivery method can also be sendmail
#SMTP_AUTH_METHOD=plain
#SMTP_OPENSSL_VERIFY_MODE=peer
#SMTP_ENABLE_STARTTLS_AUTO=true

# Optional asset host for multi-server setups
# CDN_HOST=assets.example.com

# S3 (optional)
# S3_ENABLED=true
# S3_BUCKET=
# AWS_ACCESS_KEY_ID=
# AWS_SECRET_ACCESS_KEY=
# S3_REGION=
# S3_PROTOCOL=http
# S3_HOSTNAME=192.168.1.123:9000


# S3 (Minio Config (optional) Please check Minio instance for details)
# S3_ENABLED=true
# S3_BUCKET=
# AWS_ACCESS_KEY_ID=
# AWS_SECRET_ACCESS_KEY=
# S3_REGION=
# S3_PROTOCOL=https
# S3_HOSTNAME=
# S3_ENDPOINT=

# Optional alias for S3 if you want to use Cloudfront or Cloudflare in front
# S3_CLOUDFRONT_HOST=


# Streaming API integration
# STREAMING_API_BASE_URL=


# Advanced settings
# If you need to use pgBouncer, you need to disable prepared statements:
# PREPARED_STATEMENTS=false

# Service dependencies

REDIS_HOST=redis

REDIS_PORT=6379

DB_HOST=db

DB_USER=postgres

DB_NAME=postgres

DB_PASS=

DB_PORT=5432

# Federation

LOCAL_DOMAIN=

LOCAL_HTTPS=false

# Application secrets

# Generate each with the `rake secret` task (`docker-compose run --rm web rake secret` if you use docker compose)

PAPERCLIP_SECRET=

SECRET_KEY_BASE=<secret>

OTP_SECRET=

# Registrations

# Single user mode will disable registrations and redirect frontpage to the first profile

# SINGLE_USER_MODE=true

# Prevent registrations with following e-mail domains

# EMAIL_DOMAIN_BLACKLIST=example1.com|example2.de|etc

# Only allow registrations with the following e-mail domains

# EMAIL_DOMAIN_WHITELIST=example1.com|example2.de|etc

# Optionally change default language

DEFAULT_LOCALE=fr

# E-mail configuration

# Note: Mailgun and SparkPost (https://sparkpo.st/smtp) each have good free tiers

SMTP_SERVER=smtp.mailgun.org

SMTP_PORT=587

SMTP_LOGIN=

SMTP_PASSWORD=

SMTP_FROM_ADDRESS=notifications@example.com

#SMTP_DELIVERY_METHOD=smtp # delivery method can also be sendmail

#SMTP_AUTH_METHOD=plain

#SMTP_OPENSSL_VERIFY_MODE=peer

#SMTP_ENABLE_STARTTLS_AUTO=true

# Optional asset host for multi-server setups

# CDN_HOST=assets.example.com

# S3 (optional)

# S3_ENABLED=true

# S3_BUCKET=

# AWS_ACCESS_KEY_ID=

# AWS_SECRET_ACCESS_KEY=

# S3_REGION=

# S3_PROTOCOL=http

# S3_HOSTNAME=192.168.1.123:9000

# S3 (Minio Config (optional) Please check Minio instance for details)

# S3_ENABLED=true

# S3_BUCKET=

# AWS_ACCESS_KEY_ID=

# AWS_SECRET_ACCESS_KEY=

# S3_REGION=

# S3_PROTOCOL=https

# S3_HOSTNAME=

# S3_ENDPOINT=

# Optional alias for S3 if you want to use Cloudfront or Cloudflare in front

# S3_CLOUDFRONT_HOST=

# Streaming API integration

# STREAMING_API_BASE_URL=

# Advanced settings

# If you need to use pgBouncer, you need to disable prepared statements:

# PREPARED_STATEMENTS=false

Administration

Créer un utilisateur avec l’interface de création de compte et le définir comme administrateur.

docker-compose run --rm web rails mastodon:make_admin USERNAME=&lt;user&gt;

1	docker-compose run --rm web rails mastodon:make_admin USERNAME=<user>

Sources

https://angristan.fr/installer-instance-mastodon-debian-8/

https://blog.lertsenem.com/creer-son-instance-mastodon-perso-vite-fait-mal-fait-fr.html

https://github.com/tootsuite/mastodon

https://korben.info/synchroniser-mastodon-twitter.html

Installation de Docker sur Debian Jessie

Définition

Docker est un logiciel libre qui automatise le déploiement d’applications dans des conteneurs logiciels. Selon la firme de recherche sur l’industrie 451 Research, « Docker est un outil qui peut empaqueter une application et ses dépendances dans un conteneur isolé, qui pourra être exécuté sur n’importe quel serveur Linux ». Ceci permet d’étendre la flexibilité et la portabilité d’exécution d’une application, que ce soit sur la machine locale, un cloud privé ou public, une machine nue, etc.

Installation

Se Connecter avec l’utilisateur root ou préfixer les commandes par sudo.

Faire le ménage

apt remove docker docker-engine

1	apt remove docker docker-engine

Installation des outils

<span class="gp">$ </span>sudo apt-get install <span class="se">\</span>
     apt-transport-https <span class="se">\</span>
     ca-certificates <span class="se">\</span>
     curl <span class="se">\</span>
     software-properties-common

$ sudo apt-get install \

apt-transport-https \

ca-certificates \

curl \

software-properties-common

Ajouter la clé PGP de Docker

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -

1	curl -fsSL https://download.docker.com/linux/debian/gpg \| sudo apt-key add -

Ajouter le dépôt

Ajouter la ligne suivante au fichier /etc/apt/sources.list

<span class="s2">deb [arch=amd64] https://download.docker.com/linux/debian </span>jessie <span class="s2">stable</span>

1	<span class="s2">deb [arch=amd64] https://download.docker.com/linux/debian </span>jessie <span class="s2">stable</span>

Et mettre à jour les dépôts :

apt update

1	apt update

Installer Docker

apt install docker-ce

1	apt install docker-ce

Tester

docker run hello-world

1	docker run hello-world

Installer Docker-Compose

Docker-compose est l’outil indispensable pour gérer vos images.

$ curl -L <span class="s2">"https://github.com/docker/compose/releases/download/1.11.2/docker-compose-</span><span class="k">$(</span>uname -s<span class="k">)</span><span class="s2">-</span><span class="k">$(</span>uname -m<span class="k">)</span><span class="s2">"</span> -o /usr/local/bin/docker-compose
$ chmod +x /usr/local/bin/docker-compose

$ curl -L "https://github.com/docker/compose/releases/download/1.11.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

$ chmod +x /usr/local/bin/docker-compose

Et pour l’auto complétion…

curl -L https://raw.githubusercontent.com/docker/compose/$(docker-compose version --short)/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose

1	curl -L https://raw.githubusercontent.com/docker/compose/$(docker-compose version --short)/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose

Sources

Wikipedia.org

https://docs.docker.com/engine/installation/linux/debian/

https://docs.docker.com/compose/install/

Installation et quelques tricks autour de Docker sur Debian

Installation

En fonction des plateformes il existe plusieurs méthodes, j’ai choisi celle conseillée par la documentation.

Installer les dépendances :

apt-get install apt-transport-https ca-certificates

1	apt-get install apt-transport-https ca-certificates

Ajouter la clé GPG

apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D

1	apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D

Ajouter le dépot en fonction de votre configuration dans le fichier /etc/apt/sources.list.d/docker.list

Pour Jessie : deb https://apt.dockerproject.org/repo debian-jessie main

Pour les autres distributions, se fier à la documentation.

Enfin installer les paquets…

apt-get update
apt-get install docker-engine

1 2	apt-get update apt-get install docker-engine

Pour permettre à un utilisateur autre que root de contrôler Docker

# Add the docker group if it doesn't already exist.
$ sudo groupadd docker

# Add the connected user "${USER}" to the docker group.
# Change the user name to match your preferred user.
# You may have to logout and log back in again for
# this to take effect.
$ sudo gpasswd -a ${USER} docker

# Restart the Docker daemon.
$ sudo service docker restart

# Add the docker group if it doesn't already exist.

$ sudo groupadd docker

# Add the connected user "${USER}" to the docker group.

# Change the user name to match your preferred user.

# You may have to logout and log back in again for

# this to take effect.

$ sudo gpasswd -a ${USER} docker

# Restart the Docker daemon.

$ sudo service docker restart

Configuration

Modifier les serveurs DNS

$ vi /etc/default/docker.io
 
# Use DOCKER_OPTS to modify the daemon startup options.
DOCKER_OPTS="-dns 208.67.220.220 -dns 208.67.220.222"

$ vi /etc/default/docker.io

# Use DOCKER_OPTS to modify the daemon startup options.

DOCKER_OPTS="-dns 208.67.220.220 -dns 208.67.220.222"

Installation de Docker Compose

Télécharger la version depuis GitHub

curl -L https://github.com/docker/compose/releases/download/1.6.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

1	curl -L https://github.com/docker/compose/releases/download/1.6.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

Et donner les droits d’éxécution :

<span class="hljs-keyword">chmod</span> +<span class="hljs-keyword">x</span> /usr/<span class="hljs-keyword">local</span>/bin/docker-compose

1	<span class="hljs-keyword">chmod</span> +<span class="hljs-keyword">x</span> /usr/<span class="hljs-keyword">local</span>/bin/docker-compose

Ajouter l’auto-completion pour le bash

curl -L https://raw.githubusercontent.com/docker/compose/$(docker-compose version --short)/contrib/completion/bash/docker-compose > /etc/bash_completion.d/docker-compose

1	curl -L https://raw.githubusercontent.com/docker/compose/$(docker-compose version --short)/contrib/completion/bash/docker-compose > /etc/bash_completion.d/docker-compose

Commandes

Lister les images disponibles

docker images -a

1	docker images -a

Stopper un conteneur détaché (docker run -d nom_conteneur)

docker stop nom_conteneur

1	docker stop nom_conteneur

Lister les conteneurs

docker container ls

1	docker container ls

…

Suite à venir

…

Sources

Installation

Nicolargo

https://docs.docker.com/engine/reference/run/