Sådan opretter du dit brugerdefinerede Redmine Docker-kép

Redmine før tilpasning

Bemærk: A Redmine natív dokkolóját megtalálja https://hub.docker.com/_/redmine. Her kan du også finde gode instruktioner om, hvordan du udfylder en extern database og monterer externe mapper (a telepítő bővítményekhez).

Hvis du er som mig og foretrækker at se koden direkte til opbygning af et brugerdefineret Redmine Docker-bilde, kan du gå til github.com/lcofre/redmine og tjekke Dockerfilen.

Redmine Docker-billedet er et godt udgangspunkt, selvom du sandsynligvis gerne vil tilpasse det med plugins and temaer efter din smag. Ez a vezérelt vil vi opbygge et Docker-billede baseret det officielle, tilføje nogle temaer and plugins and uploaded det til docker-registret.

For enkelhedens skyld vil vi ikke bruge en ekstern database, men en intern database i Redmine-containeren selv. Til en produktionsmiljø anbefales det dog és oprette en dedikeret lagercontainer.

Plugins és téma

Vi har valgt nogle plugins og temaer for at illustrere forskellige måder at tilføje dem til Redmine:

• Skjul sidebjælke, et plugin der giver mere skærmplads, især når du skriver sager
• Indsæt fra udklipsholder, til at vedhæfte skærmibleder ved at indsætte fra udklipsholderen i stedet for at vælge en fil
• A1 og Gitmike, to temaer der ændrer udseendet af brugergrænsefladen

Vi udelukker plugins, der kræver en adatbázis migráció, da du har brug for en forudgående eksisterende database. Kommentár nedenfor, hvis du har brug for installere et plugin, der kræver migrationer, da vi har gode ideer til dig.

Skriv Dockerfilen

En Dockerfil er en opskrift på, hvordan man bygger et Docker-kép. Det første faktum, vi vil lære her, er, at vi skal basere vores billede på et andet billede, så vi vil bruge det officielle til Redmine

FRA Redmine

A Dockerfilen legfrissebb verziója a legújabb és legfrissebb verzió, 4.1.0 a skrivetidspunktet alapján készült. Da dette vil hente hvilken som helst nyeste version, kan du foretrække at bruge en specifik version for at undgå uventede nye versioner, der kan bryde opbygningen af ​​dette billede

FRA Redmine: 4.1.0

Brug af Git til és Hente komponenterne

I de fleste tilfælde har temaer and plugins git-repositorier, hvor vi can downloaded from the newste code. Dette gælder for følgende tre komponenter.

Den grundlæggende Redmine-kép kommer uden git, men vi kan tilføje det til billedet på denne måde

RUN apt install -y GIT

Dette vil blive udført, når billedet bygges, og vil tillade dig and bruge git i de følgende instruktioner.

Gitmike-tema: de anbefaler at klone deres repo direkte

RUN git klón https://github.com/makotokw/redmine-theme-gitmike.git nyilvános / themes / gitmike

Linjen vil gemme det klonede projekt i den passende mapppe public/themes

Skjul sidebjælken: Ugyanaz az eljárás, mint a pluginok használata. Denne kræver ikke mere end at placere den klonede mappe i plugins-mappen

RUN git klón https://gitlab.com/bdemirkir/sidebar_hide.git plugins / sidebar_hide

Vágólap Indsæt kép: Dette virker også som den typiske procedúra, klon repoet, og du er klar til at gå

RUN git klón https://github.com/RubyClickAP/clipboard_image_paste.git plugins / clipboard_image_paste

Men hvis du læser lidt mere vil du se, at "det anbefales at installere RMagick-gemmen, ellers vises vedhæftede billeder ikke i exporterede PDF-filer". Så hvordan gør vi det? Det burde være lige så nemt som

Futtassa a gem install rmagick szoftvert

men du ved nok, at gemmen skal bygges, før den kan installeres, så du skal installere nogle pakker, før du installerer gemmen. Linjen, du virkelig har brug for, er

Futtassa a telepítést - ha épít-nélkülözhetetlen imagemagick libmagickcore-dev libmagickwand-dev ruby-dev \

       && gem install rmagick

Alt i en kommando, adskilt i to linjer for læsbarhed.

Az oprindelige forfatter af dette plugin giver ikke en version til Redmine 4, men en søgning på pluginnavnet a GitHub førte mig til et projekt, der gør det: RubyClickAP / clipboard_image_paste.

Jelölje ki a plugin vagy a téma letöltését

A1-temaet er et godt exempel på at illustrere tilfældene, hvor du har kilden, men ikke en URL til at downloade under bygningsprocessen. En mulighed i sådanne tilfælde er at give kilden til bygningsprocessen. På den måde tilføjes indholdet til billedet uden at downloade det

MÁSOLÁS a1 nyilvános / témák / a1

Dette kræver, at a1-mappen er på samme sted som Dockerfilen.

Nu er du klar til at bygge dit billede, så åbn en terminal, hvor din Dockerfil er, og udfør

dokkoló építés - my-redmine.

Når det er bygget, kan du køre dit billede med

dokkoló futtatása -p-3000: 3000 - neve my-redmine my-redmine

Gå videre og åbn http://localhost:3000 for at se dit tilpassede Redmine!

Redmine efter tilpasning

Nézze meg a tippeket a bővítmények használatához

A prøve nye plugins er det altid bedre and bruge en frsk Redmine-container. Det er sådan, jeg opdagede, rmagick kræver, and nogle pakker installeres. Kør først en kassérbar instans af Redmine med

dokkoló fut - rm -d -p 3000: 3000 - név teszt-redmine redmine

og gå derefter ind i instansen med

dokkoló végrehajtja - teszt-redmine bash

Telepítheti az OS-csomagot, a drágaköveket vagy a migrációs eszközöket. Husk bare trinnene, så du kan tilføje dem til din Dockerfil!

Overførsel af dit brugerdefinerede docker Hub

Billedet, du lige har bygget, er kun tilgængeligt i din lokale miljø. Hvad nu hvis du vil gøre det tilgængeligt for andre, lad os sige for alle? Selvfølgelig kan du uploade Dockerfilen og relaterede filer til et git repo, og de érdekli kan bygge billedet selv. Men Docker giver dig også mulighed for at uploade det byggede billed til de register. For at gøre det skal du oprette en account på hub.docker.com også oprette et repository til dit billede. Derefter logger du ind i terminalen på denne måde

dokkoló bejelentkezés

Tag dit billede, så det kan uploads til dit repo

docker tag my-redmine: legújabb lcofre / redmine: legújabb

og push det på denne måde

dokkoló push lcofre / redmine: legújabb

Docker-kép és Docker-registret

Nu kan alle prøve dit billeded ved at gøre følgende

dokkoló futtatása -p-3000: 3000 - neve my-redmine lcofre / redmine

Det er det! Sådan går du fra en standard Redmine-installation til en personlig version, der er tilgængelig i Docker-registret. Del gerne dine kommentarer eller spørgsmål nedenfor.

Reducer størrelsen a Docker-billedet

Du vil opdage, at Dockerfilen i repoet har slået mange linjer sammen til en. Dette er en anbefaling from Docker for and Gøre Billederne Mindre. Du kan finde dette råd og andre på https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

En anden anbefaling for at reductionre den endelige størrelse på billedet er at bruge alpes-versionen af ​​Redmine

FRA Redmine: alpesi

Alpine en anden Linux-terjesztés. I stedet for at bruge apt til at installere pakker skal du bruge apk.

Et sidste tipp: De pakker, vi installerede med apt i Dockerfilen, er ikke længere nødvendige efter, at billedet er bygget. Du kan følge bestste praksis ved at bruge többlépcsős buildek: https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#use-multi-stage-builds

Praksissen med at holde et lille Docker-kép hjælper især, når antallet af instanser skaleres op, men reduktor også angrebsfladen a dit billed.