Déployer une stack Gitea

Déployer Gitea

Afin de pouvoir déployer une stack Gitea vous pouvez suivre la documentation officielle du projet :

Documentation Gitea

Pour ce faire vous devez disposer :

• d'un système GNU/Linux fonctionnel auquel vous aurez accès en SSH
• de docker et de docker compose fonctionnel

Vous pouvez réaliser cette installation depuis une Machine Physique, une machine Virtuelle ou d'une Instance CLoudStack, pour la suite de l'article nous allons détailler l'installation sur une Instance CLoudStack.

Déploiement de l'instance

Connectez-vous sur votre interface de gestion [Cloud Ikoula One]

Préparation et déploiement d'une instance unique en zone Basic

la première étape sera de créer un groupe de sécurité qui sera dédié à cette tâche (prenez soin après coup de déployer une règle "Ingress" pour autoriser l'accès au port 22).

• rendez-vous dans la catégorie "Network"

Une fois réaliser déployer une instance en zone "Basic" à l'aide du template sponsorisé de votre choix (nous allons sélectionner un template Debian 9 pour l'exemple).

• rendez-vous dans la catégorie "Instance", Prenez soin à sélectionner le groupe de sécurité dans la liste déroulante de réseau disponible.

Vous pouvez suivre notre guide de démarrage sur CloudStack au besoin

• Connectez-vous sur le serveur et mettez à jour le système au besoin

# apt update && apt full-upgrade

Préparation du système

• Docker

Vous devez procéder à l'installation de docker sur votre système, nous recommandons d'utiliser de préférence le dépôts officiel nettement plus à jour que celui de Debian. Pour ce faire nous vous invitons à suivre la documentation officielle de Docker, prenez soin de bien suivre les recommandations "postinstall".

Dans notre exemple pour Debian :

Documentation docker Debian

• Docker compose

Afin de faciliter le déploiement de Gitea nous recommandons fortement de suivre la documentation anglaise proposant un fichier docker compose, vous devez donc procéder à l'installation de celui-ci

Sur Debian pour notre exemple :

- Il faut commencer par installer l'utilitaire pip

# apt install python-pip

- Une fois pip installer vous allez pouvoir déployer docker-compose

# pip install docker-compose

Vous voilà avec le minimum requis pour le déploiement de Gitea via Docker-compose

Déploiement de Gitea

Le déploiement de votre "Stack" Gitea sera réalisé à l'aide d'un fichier compose que vous aurez au préalablement créer ou déposer dans un dossier auquel l'utilisateur aura le droit.

Dans notre exemple nous déploierons avec le support de Postgres comme SGBDR :

version: "2"

networks:
  gitea:
    external: false

services:
  server:
    image: gitea/gitea:latest
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    networks:
      - gitea
    volumes:
      - /var/lib/persistent/gitea:/data
    ports:
      - "3000:3000"
      - "222:22"
    depends_on:
      - db

  db:
    image: postgres:9.6
    restart: always
    environment:
      - POSTGRES_USER=gitea
      - POSTGRES_PASSWORD=gitea
      - POSTGRES_DB=gitea
    networks:
      - gitea
    volumes:
      - /var/lib/persistent/postgres:/var/lib/postgresql/data

Une fois déployer à l’aide de votre utilisateur, n'oubliez pas de procéder à l'ouverture du port 3000 dans votre "Security Group" tout comme le port 22 auparavant.

Vous devriez pouvoir désormais vous connectez en Web et en SSH sur votre Stack Gitea :