Kom och skapa dig en bild av Docker personalizzata di Redmine.

Redmine prima della personalizzazione

anteckning: Redmine nativo docker può essere trovato su https://hub.docker.com/_/redmine. Qui puoi trovare anche buone istruzioni su come popolare un databas esterno e montare cartelle esterne (per poter installare plugin).

Se sei come me e preferisci vedere direttamente il codice per la creazione di un'immagine Docker personalizzata di Redmine, puoi andare su github.com/lcofre/redmine e kontrolllare il Dockerfile.

L'immagine Docker di Redmine è un puon punto di partenza, anche se probabilmente vorresti personalizzarla con plugin e temi a tuo piacimento. I fråga om hur man gör, costruiremo un'magine Docker basata su quella ufficiale, aggiungeremo alcuni temi e la caricheremo nel registro docker.

Icke-användning en databas esterno ma en databas internt innehåll Redmine stesso. Tuttavia, per un ambiente di produzione, è consigliabile configurare un contenitore di archiviazione dedicato.

Plugin och Temi

Abbiamo scelto alcuni plugin och temi för illustrare olika modalità di aggiunta a Redmine:

• Nascondi la barra laterale, un plugin per consentire più spazio sullo schermo, soprattutto durante la scrittura di problemi
• Incolla dagli appunti, per allegare skärmdump incollando dagli appunti invece di selezionare un fil
• A1 e Gitmike, due temi per cambiare l'aspetto dell'interfaccia utente

Escludiamo i plugin che richiedono una migrazione del database, poiché è necessario un databas preesistente. Commenta qui sotto se hai bisogno di installare un plugin che richiede migrazioni, poiché abbiamo buone idee per te.

Skriv till Dockerfile

Un Dockerfile è una ricetta su come creare un'magine Docker. La prima cosa che impareremo qui è che dobbiamo basare la nostra immagine su un'altra immagine, quindi utilizzeremo quella ufficiale per Redmine

FRÅN Redmine

Questa prima riga del Dockerfile baserà la nostra immagine sull'ultima e migliore immagine, 4.1.0 al momento della scrittura. Poiché questo prenderà qualsiasi versione sia la più recente, potresti preferire utilizzare una versione specifica per evitare nuove versioni inaspettate che potrebbero rompere la creazione di questa immagine

FRÅN Redmine: 4.1.0

Använd Git per ottenere i componenti

Nella maggior parte dei casi, i temi ei plugin hanno repository Git da cui possiamo scaricare il codice più recente. Questo è il caso dei seguenti tre componenti.

L'immagine di base di Redmine viene fornita senza Git, ma possiamo aggiungerlo all'immagine in questo modo

KÖR apt installation -y git

Questo verrà eseguito quando l'immagine viene creata e ti consentirà di utilizzare Git nelle istruzioni seguenti.

Tema Gitmike: consigliano di clonare direttamente il loro repository

KÖR GIT-klon https://github.com/makotokw/redmine-theme-gitmike.git offentliga / themes / gitmike

La linea salverà il progetto clonato nella cartella appropriata offentliga/teman

Nascondi la barra laterale: la stessa procedura può essere applicata ai plugin. Questo richiede solo di posizionare la cartella clonata nella cartella dei plugin

KÖR GIT-klon https://gitlab.com/bdemirkir/sidebar_hide.git plugins / sidebar_hide

Incolla imagine negli appunti: anche questo sembra essere la procedura tipica, clona il repository e sei pronto per partire

KÖR GIT-klon https://github.com/RubyClickAP/clipboard_image_paste.git plugins / clipboard_image_paste

Men om leggi un po' di più vedrai che "è consigliabile installare la gemma RMagick, altrimenti le immagini allegati non verranno visualizzate nei file PDF esportati". Är du redo? Dovrebbe essere facile komma

KÖR pärla installera rmagick

ma probabilmente sai che la gemma deve essere compilata prima di poter essere installata, quindi devi installare alcuni pacchetti prima di installare la gemma. La linea di cui hai veramente bisogno è

KÖRA apt install -y build-essential imagemagick libmagickcore-dev libmagickwand-dev ruby-dev \

       && gem installera rmagick

Tutto in un unico comando, separato in due righe per leggibilità.

L'autore originale di questo plugin non fornisce una versione per Redmine 4, ma una ricerca del nome del plugin su GitHub mi ha portato su un progetto che lo fa: RubyClickAP / clipboard_image_paste.

Aggiungera ett plugin för ett tema da una fonte scaricata

Il tema A1 è un buon esempio per illustrare i casi in cui si ha la fonte, ma non un URL da scaricare durante il processo di creazione. Una opzione in casi come questo è fornire la fonte al processo di creazione. In questo modo il contenuto viene aggiunto all'immagine senza scaricarlo

COPY a1 public / teman / a1

Questo richiede che la cartella a1 sia nello stesso posto in cui si trova il Dockerfile.

Ora sei pronto per creare la tua immagine, quindi apri un terminale dove si trova il tuo Dockerfile ed esegui

docker build -t my-redmine.

Una volta creata, sarai in grado di eseguire la tua immagine con

docker run -it -p 3000: 3000 - namn min-redmine my-redmine

Vai avanti e apri http://localhost:3000 per vedere il tuo Redmine personalizzato!

Redmine dopo la personalizzazione

Alcuni consigli per aggiungere più plugin

Per provare ny plugin, è semper meglio använder en ny innehåll Redmine. È così che ho capito che rmagick richiede l'installazione di alcuni pacchetti. Prima, esegui un'istanza eliminabile di Redmine con

docker run --rm -d -p 3000: 3000 - namn test-redmine redmine

e poi accedi all'istanza con

docker exekvera -it test-redmine bash

Lì puoi installera pacchetti OS, gemme eller eseguire migrazioni. Ricorda solo och passaggi in modo da poterli aggiungere al tuo Dockerfile!

Caricamento della tua föreställ dig personliga lösningar på Docker Hub

L'immagine che hai appena creato è disponibile solo nel tuo ambiente locale. E se volessi renderla disponibile ad altri, diciamo a tutti? Naturalmente, puoi caricare il Dockerfile ei fil correlati su un repository git e chi è interessato può creare l'immagine da solo. Ma Docker ti consente anche di caricare l'immagine creata nel loro registro. Du kan skapa ett konto på hub.docker.com och skapa ett arkiv för dig. Quindi accedi al terminale i questo modo

docker-inloggning

Tagga la tua föreställa sig i modo che possa essere caricata nel tuo förvaret

docker tag my-redmine: senaste lcofre / redmine: senaste

e caricala in questo modo

docker push lcofre / redmine: senaste

Föreställ dig Docker och registrera Docker

Ora chiunque può provare la tua immagine eseguendo

docker run -it -p 3000: 3000 - name my-redmine lcofre / redmine

Ecco fatto! Om du vill avinstallera standarden för Redmine kan du använda en personlig version som är tillgänglig för Docker. Condividi i tuoi commenti o domande qui sotto.

Riduzione delle dimensioni dell'image Docker

Troverai che il Dockerfile nel repository ha unito molte righe in una sola. Questa è una raccomandazione di Docker per creare immagini più piccole. Puoi trovare questo consiglio e altri su https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

Un'altra raccomandazione per ridurre le dimensioni finali dell'immagine è quella di utilizzare la versione alpina di Redmine

FRÅN Redmine: alpin

Alpine è una distribution Linux diversa. Invece di usare apt per installationare i pacchetti, devi usare apk.

Un ultimo suggerimento: i pacchetti che abbiamo installato con apt nel Dockerfile non sono più necessari dopo la creazione dell'immagine. Puoi seguire la pratica migliore di utilizzare bygga i flera steg: https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#use-multi-stage-builds

La pratica di mantenere un'immagine Docker di piccole dimensioni aiuta soprattutto quando si aumenta il numero di istanze, ma riduce anche la superficie di attacco della tua immagine.