Kuinka luoda oma räätälöity Redmine Docker -obraz

Redmine ennen mukauttamista

Huomio: Redmine:n alkuperäinen wersja dokera löytyy osoitteesta https://hub.docker.com/_/redmine. Täältä löydät myös hyviä ohjeita ulkoisen tietokannan täyttämiseen ja ulkoisten kansiojen liittämiseen (jotta voit asentaa lisäosia).

Jos haluat kuten minä nähdä suoraan koodin räätälöidyn Redmine Docker-kuvan rakentamiseksi, voit siirtyä osoitteeseen https://github.com/lcofre/redmine ja tarkistaa Dockerfile:n.

Redmine Docker-kuva na hyvä lähtökohta, vaikka todennäköisesti haluat mukauttaa sitä lisäosilla ja teemoilla oman mieltymyksesi mukaan. Tässä ohjeessa rakennamme Docker-kuvan virallisen kuvan pohjalta, lisäämme joitain teemoja ja lisäosia sekä lataamme sen docker-rekisteriin.

Yksinkertaisuuden vuoksi emme käytä ulkoista tietokantaa, vaan Redmine-kontin sisäistä tietokantaa. Tuotantoympäristössä na kuitenkin suositeltavaa asentaa omistettu Tallennuskontti.

Lisäosat ja teemat

Olemme valinneet muutamia lisäosia ja teemoja, jotka havainnollistavat erilaisia ​​tapoja lisätä ne Redmineen:

• Piilota sivupalkki, lisäosa, joka mahdollistaa enemmän näyttötilaa, erityisesti ongelmien kirjoittamista varten
• Liitä leikeöydältä, jolla voit liittää näyttökuvia suoraan leikepöydältä tieoston valitsemisen sijaan
• A1 ja Gitmike, kaksi teemaa, jotka muuttavat käyttöliittymän ulkonäköä

Jätämme pois lisäosat, jotka vaativat tietokannan siirtämistä, koska tarvitset valmiiksi olemassa olevan tietokannan. Jos tarvitset asentaa lisäosan, joka vaatii siirtämisen, jätä kommentti alle, sillä meillä on hyviä ideoita sinulle.

Dockerfilen kirjoittaminen

Dockerfile na resepti Docker-kuvan raentamiseen. Ensimmäinen asia, jonka opimme täällä, on se, että meidän on perustettava kuva johonkin toiseen kuvaan, joten käytämme viralista Redmine-kuvaa

Z Redmine

Tämä Dockerfilen ensimmäinen rivi perustaa kuvamme uusimpaan ja parhaaseen kuvaan, 4.1.0 kirjoitushetkellä. Koska tämä hakee aina uusimman wersja, saatat haluta käyttää tiettyä versiota välttääksesi odottamattomia uusia versioita, jotka saattavat rikkoa tämän kuvan rakentamisen

Z Redmine: 4.1.0

Komponenttien hankkiminen Gitin avulla

Użyj immissa tapauksissa teemoilla ja liitännäisillä na git-repositoriot, joista voimme ladata uusimman koodin. Tämä pätee seuraaviin kolmeen komponenttiin.

Pohja-Redmine-kuva ei sisällä gitia, mutta voimme lisätä sen kuvaan seuraavasti

Uruchom RUN apt install -y git

Tämä suoritetaan, kun kuva rakennetaan, ja se mahdollistaa gitin käytön seuraavissa ohjeissa.

Gitmike-teema: on suosittelev kloonaamaan heidän repoaan suoraan

URUCHOM klon git https://github.com/makotokw/redmine-theme-gitmike.git public / themes / gitmike

Tämä rivi talentaa kloonatun projektin oikeaan kansioon public/themes

Ukryj pasek boczny: Sama menettely voidaan soveltaa liitännäisiin. Tämä ei vaadi muuta kuin kloonatun kansion sijoittamisen liitännäisten kansioon

URUCHOM klon git https://gitlab.com/bdemirkir/sidebar_hide.git plugins / sidebar_hide

Wklej obraz ze schowka: Tämä vaikuttaa myös tyypilliseen menettelyyn, kloonaa repo ja olet valmis

URUCHOM klon git https://github.com/RubyClickAP/clipboard_image_paste.git plugins / clipboard_image_paste

Musze to zrobić lue hieman lisää huomaat, että „on suositeltavaa asentaa RMagick-kivi, muuten liitetyt kuvat eivät näy PDF-tiedostoissa”. Kuinka tama tehdään? Sen pitäisi olla yhtä helppoa kuin

URUCHOM gem zainstaluj rmagick

mutta tieät varmaan, että kiven na rakennettava ennen kuin se voidaan asentaa, joten sinun na asennettava joitain paketteja ennen kiven asentamista. Rivi na Tarvitsemasi

URUCHOM apt install -y build-essential imagemagick libmagickcore-dev libmagickwand-dev ruby-dev \

       && gem zainstaluj rmagick

Kaikki yhdessä komennossa, jaettuna kahteen riviin luettavuuden vuoksi.

Tämän liitännäisen alkuperäinen tekijä ei tarjoa versiota Redmine 4:lle, mutta liitännäisen nimen etsiminen GitHubista johti projektiin, joka tarjoaa: RubyClickAP / clipboard_image_paste.

Liitännäisen tai teeman lisääminen ladatusta lähteestä

A1-teema na hyvä esimerkki tapauksista, joissa sinulla na lähdekoodi, mutta ei URL-osoitetta lataamista varten rakennusprosessin aikana. Yksi vaihtoehto tällaisissa tapauksissa na antaa lähde rakennusprosessille. Tällä tavoin sisältö lisätään kuvaan lataamatta sitä

KOPIUJ a1 public / themes / a1

Tämä edellyttää, että a1-kansio na samassa paikassa kuin Dockerfile.

Nyt olet valmis rakentamaan kuvan, joten avaa terminaali, jossa Dockerfile on, ja suorita

docker buduje -t my-redmine.

Kun kuva na rakennettu, voit käyttää sitä seuraavasti

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

Mene ooitteeseen http://localhost:3000 nähdäksesi mukautetun Redminen!

Redmine mukauttamisen jälkeen

Joitain vinkkejä lisäliitännäisten lisäämiseen

Uusien liitännäisten kokeilemiseksi on aina parempi käyttää uutta Redmine-konttia. Tämän avulla huomasin, että rmagick vaatii joitain asennettavia paketteja. Aja ensin Redminen hävitettävä instanssi komennolla

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

ja siirry sitten instanssiin komennolla

docker exec - it test-redmine bash

Siella voit asentaa käyttöjärjestelmän paketteja, kiviä tai suorittaa migraatioita. Musisz na próżno vaiheet, jotta voit ne Dockerfileesi!

Bezpłatne Lataa mukautettu obraz Docker Hubiin

Kuva, jonka juuri loit, na saatavilla vain paikallisessa ympäristössäsi. Entä jos haluat tehdä sen saataville muille, sanotaanko kaikille? Tietysti voit ladata Dockerfile-tiedoston ja siihen liittyvät związany git-repoon, ja kiinnostuneet voivat rakentaa kuvan ite. Mutta Docker mahdollistaa myös rakennetun kuvan lataamisen heidän rekisteriinsä. Siihen luo tili osoitteessa hub.docker.com ja luo myös kuvallesi oma tietovarasto. Sitten kirjaudu sisään terminaalissa näin

login dokera

Merkitse kuvasi, jotta se voidaan ladata tietovarastoosi

tag dokera my-redmine: najnowsze lcofre / redmine: najnowsze

ja lähetä se nain

docker push lcofre / redmine: najnowszy

Docker-kuvan Docker-rekisteri

Nyt kuka tahansa voi kokeilla kuvaa tekemällä näin

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

Siinä kaikki! Näin siirryt tavallisesta Redmine-asennuksesta räätälöityyn wersja, żart na saatavilla Docker-rekisterissä. Jaa kommenttisi tai kysymyksesi alla.

Docker-kuvan koon pienentäminen

Huomaat, että plik Dockerfile tietovaraston yhdisti monta riviä yhdeksi. Tämä na Dockerin suositus pienempien kuvien luomiseksi. Voit löytää tämän neuvon ja muita osoitteesta https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

Toinen suositus kuvan lopullisen koon pienentämiseksi on käyttää Redminen alpine-versiota

FROM Redmine: alpejski

Alpine na komputerze z systemem Linux. Sen sijaan, että käytät apt:ää pakettien asentamiseen, sinun on käytettävä apk:ta.

Viimeinen vinkki: Dockerfilessa apt:lla asennetut paketit eivät enää ole tarpeen kuvan rakentamisen jälkeen. Voit noudattaa parasta käytäntöä käyttämällä monivaiheisia rakennuksia: https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#use-multi-stage-builds

Pienikokoisen Docker-kuvan säilyttäminen auttaa erityisesti, kun lisäät instanssien määrää, mutta se myös vähentää hyökkäyspintaa kuvassasi.