Hogyan hozzunk létre egyéni Redmine Docker képet?

Redmine előtt testreszabás

Megjegyzé'ler: A Redmine natív docker elérhető a https://hub.docker.com/_/redmine oldalon. Itt jó útmutatókat is találhat arról, hogyan lehet külső adatbázist feltölteni és külső mappákat csatolni (a pluginek telepítéséhez).

Ha hasonlóan gondolkodik, mint én, és inkább közvetlenül szeretné látni a testreszabott Redmine Docker kép kódját, akkor látogasson el a github.com/lcofre/redmine oldalra, és ellenőrizze a Dockerfile-t.

A Redmine Docker kép jó kiindulópont, bár valószínűleg szeretné testreszabni a saját kedvenc plugineivel és témáival. Ebben a how-to-ban egy Docker képet fogunk építeni az hivatalos képre alapozva, hozzáadunk néhány témát és plugint, majd feltöltjük a docker registry-be.

Az egyszerűség kedvéért nem használunk külső adatbázist, hanem egy belső adatbázist használunk a Redmine konténerben magában. Azonban egy termelési környezetben ajánlott egy dedikált tároló konténer beállítása.

Pluginek és témák

Választottunk néhány plugint és témát, hogy bemutassuk a Redmine-hez való különböző hozzáadási módokat:

• Oldalsáv elrejtése, egy plugin, amely lehetővé teszi a nagyobb képernyőterületet, különösen akkor, amikor problémákat írunk
• Vágólap beillesztése, hogy képernyőképeket csatoljon a vágólapról, ahelyett, hogy kiválasztana egy fájlt
• A1 és Gitmike, két téma, amely megváltoztatja a felhasználói felület kinézetét

Kizárjuk azokat a plugineket, amelyek adatbázis-migrációt igényelnek, mivel előre létező adatbázisra van szükségük. Ha olyan plugint szeretne telepíteni, amely migrációkat igényel, akkor kérjük, kommentelje alá, mivel van jó ötleteink.

A Dockerfile írása

A Dockerfile egy recept arról, hogyan kell egy Docker képet építeni. Az első tény, amit itt megtanulunk, az az, hogy másik képre kell alapoznunk a képünket, így a hivatalos Redmine képet fogjuk használni.

Redmine'dan

A Dockerfile első sora az utolsó és legnagyobb képre alapozza a képünket, amely a 4.1.0 verzió a jelenlegi írásbeli időpontban. Mivel ez a legfrissebb verziót fogja letölteni, előnyösebb lehet egy adott verziót használni, hogy elkerüljük azokat az váratlan új verziókat, amelyek tönkretehetik ezt a képet.

BAŞLANGIÇ Redmine: 4.1.0

A Git használata a komponensek letöltéséhez

A legtöbb esetben a témák és bővítmények Git tárolókkal rendelkeznek, ahol letölthetjük a legfrissebb kódot. Ez igaz a következő három komponensre.

Az alap Redmine kép nem tartalmaz Git-et, de hozzáadhatjuk a képhez ezt a módszert használva:

ÇALIŞTIR apt install -y git

Ez végrehajtódik, amikor a kép épül, és lehetővé teszi a Git használatát a következő utasításokban.

Gitmike témája: javasolják, hogy közvetlenül klónozzuk a repo-jukat

RUN git klonu https://github.com/makotokw/redmine-theme-gitmike.git kamu / temalar / gitmike

Ez a sor menti a klónozott projektet a megfelelő mappába, a public/themes-be.

Oldalsáv elrejtése: Ugyanez a folyamat alkalmazható bővítményekre is. Ehhez semmi másra nincs szükségünk, csak a klónozott mappa elhelyezésére a bővítmények mappájában.

RUN git klonu https://gitlab.com/bdemirkir/sidebar_hide.git eklentileri / sidebar_hide

Vágólap kép beillesztése: Ez is úgy tűnik, hogy a tipikus eljárás, klónozzuk a repo-t, és kész is vagyunk.

RUN git klonu https://github.com/RubyClickAP/clipboard_image_paste.git eklentileri / clipboard_image_paste

De ha tovább olvasunk, láthatjuk, hogy "ajánlott az RMagick gem telepítése, különben a csatolt képek nem jelennek meg az exportált PDF fájlokban". Tehát hogyan kell ezt megtenni? Ez olyan egyszerűnek tűnik, mint

RUN gem kurulum rmagick

de valószínűleg tudod, hogy a gem-nek épülnie kell, mielőtt telepíthető lenne, tehát szükséged van néhány csomag telepítésére a gem telepítése előtt. Az a sor, amire valóban szükséged van, az:

RUN apt install -y yap-temel imagemagick libmagickcore-dev libmagickwand-dev ruby-dev \

       && gem install rmagick

Minden egyetlen parancsban, két sorba szétválasztva az olvashatóság érdekében.

A plugin eredeti szerzője nem biztosít verziót a Redmine 4-hez, de a plugin nevének keresése a GitHub-on egy olyan projektre vezetett, amely igen: RubyClickAP / clipboard_image_paste.

Bővítmény vagy téma hozzáadása letöltött forrásból

A A1 téma jó példa arra, hogy bemutassuk azokat az eseteket, amikor rendelkezünk a forrással, de nincs URL a letöltéshez a build folyamat során. Ebben az esetben az egyik lehetőség az, hogy a forrást a build folyamatához adjuk. Így a tartalom hozzáadódik a képhez letöltés nélkül.

KOPYA a1 genel / temalar / a1

Ehhez az a1 mappának ugyanazon a helyen kell lennie, ahol a Dockerfile található.

Most már készen állsz a kép építésére, tehát nyiss meg egy terminált, ahol a Dockerfile található, és hajtsd végre a következő parancsot:

docker yapı -t benim-redmin.

Amint elkészült, futtathatod a képedet:

docker run -it -p 3000: 3000 - adı benim-redmin benim-redmin

Nyisd meg a http://localhost:3000 címet, hogy megnézd a testreszabott Redmine-odat!

A testreszabott Redmine

Néhány tipp a bővítmények hozzáadásához

Az új bővítmények kipróbálásához mindig jobb egy friss Redmine konténert használni. Így jöttem rá, hogy az rmagick-hez néhány csomagot telepíteni kell. Először futtass egy eldobható Redmine példányt:

docker çalıştırmak - rm -d -p 3000: 3000 - adı test-redmine redmine

és lépj be a példányba:

docker exec -it testi-redmine bash

Itt telepíthetsz operációs rendszer csomagokat, gem-eket vagy futtathatsz migrációkat. Csak emlékezz a lépésekre, hogy hozzáadhassuk őket a Dockerfile-hoz!

A saját kép feltöltése a Docker Hub-ra

Az általad épített kép csak a helyi környezetedben érhető el. Mi van akkor, ha mások is hozzáférhetnek hozzá, mondjuk mindenki? Természetesen feltöltheted a Dockerfile-t és a kapcsolódó fájlokat egy git repo-ba, és az érdeklődők maguk is építhetik a képet. De a Docker lehetővé teszi a kép feltöltését a regisztrációjukba is. Ehhez hozz létre egy fiókot a hub.docker.com-on, és hozz létre egy tárolót a képedhez. Ezután jelentkezz be a terminálban így

liman işçisi girişi

Címkézd a képedet, hogy feltölthető legyen a tárolódba

docker etiketi my-redmine: latest lcofre / redmine: latest

és töltsd fel így

docker push lcofre / redmine: en yeni

A Docker kép a Docker regisztrációban

Most bárki kipróbálhatja a képedet azzal, hogy

docker run -it -p 3000: 3000 - adı my-redmine lcofre / redmine

Ennyi az egész! Így juthatsz el egy szabványos Redmine telepítéstől egy a Docker regisztrációban elérhető személyre szabott verzióig. Kérjük, ossza meg velünk a megjegyzéseit vagy kérdéseit az alábbiakban.

A Docker kép méretének csökkentése

Az a repo-ban található Dockerfile több sort egybeolvasztott. Ez a Docker ajánlása a kisebb képek létrehozása érdekében. Ezt és más ajánlásokat megtalálhatod itt: https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

Egy másik ajánlás a kép végső méretének csökkentésére az alpine verzió használata a Redmine-ban

KİMDİR Redmine: alpin

Az Alpine egy másik Linux disztribúció. Ahelyett, hogy az apt segítségével telepítenéd a csomagokat, az apk-t kell használnod.

Egy utolsó tipp: az apt segítségével telepített csomagok a Dockerfile-ban már nem szükségesek a kép elkészültével. Követheted a legjobb gyakorlatot, és több szakaszos építést használhatsz: https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#use-multi-stage-builds

A kis méretű Docker kép megtartása különösen hasznos, amikor növeled a példányok számát, de csökkenti a képed támadási felületét is.