Korleis lage di eiga tilpassa Redmine Docker-bilete

6/16/2020
8 minut
Lukáš Beňa
Redmine er eitt av dei populære verktøya for prosjektstyring and oppfølging av problem. Om du har prøvd det nebo måtte installere det i ein produksjonsmiljø, veit du sannsynlegvis agså at det finst eit offisielt Docker-bilete jsem gjer installasjon og skalering mykje enklare for høgtrafikkmiljø.

Redmine pro tilpasning

Značka: Redmine native docker kan finnes på https://hub.docker.com/_/redmine. Her kan du også finne gode instruksjoner om hvordan du fyller en ekstern database og monterer eksterne mapper (pro å kunne installere plugins).

Hvis du er som meg og foretrekker å se koden direkte for å bygge et tilpasset Redmine Docker-bilde, kan du gå til github.com/lcofre/redmine nebo sjekke Dockerfile.

Redmine Docker-bildet er and godt utgangspunkt, selv om du sannsynligvis vil tilpasse det with plugins and temaer du liker. I den veiledningen in vi bygge and Docker-bilde basert på det offfisielle, legge til noen temaer and plugins, and laste det opp til docker-registret.

Máte přístup k skyld vi ikke bruke en ekstern databáze, muži a interní databázi a Redmine-containeren selv. Pro et produksjonsmiljø anbefales det imidlertid å sette opp en dedikert lagringscontainer.


Pluginy a témata

K dispozici jsou žádné pluginy a témata pro ilustrační soubor pro použití v Redmine na:

  • Boční panel Skjul, en plugin som gir mer skjermplass, spesielt når du skriver saker
  • Lim inn fra utklippstavlen, pro å legge ved skjermbilder ved å lime inn fra utklippstavlen i stedet for å velge en fil
  • A1 og Gitmike, to temaer pro å endre utseendet på brukergrensesnittet

V ekskluderer plugins jsem krev v databázioppdatering, da du trenger a eksisterende databáze. Vennligst commenter nedenfor hvis du trenger å installere en plugin som krever oppdateringer, da vi har gode ideer til deg.


Dockerfile Skriver

En Dockerfile er en oppskrift på hvordan du bygger et Docker-bilde. Det første vi vil lære her er at vi må basere bildet vårt på et annet bilde, så vi vil bruke det offisielle for Redmine

FRA Redmine

Denne første linjen i Dockerfile nebo základní obrázek vårt vå den nyeste og beste versjonen, 4.1.0 na skrivetidspunktet. Siden dette vil hente hvilken jsem helst versjon som er nyeste, kan du foretrekke å bruke en spesifikk versjon for å unngå uventede nye versjoner som kan ødelegge byggingen av dette bildet

FRA Redmine: 4.1.0


Å bruke Git pro å få komponentene

I de fleste tilfeller har temaer og utvidelser git-repositorier der vi kan laste ned den nyeste koden. Dette gjelder pro følgende tři komponenty.

Den grunnleggende Redmine-bildet kommer uten git, men vi kan legge det til bildet på denne måten

SPUSTÍTE apt install -y git

Dette vil bli utført når bildet bygges og vil tillate deg å bruke git i de følgende instruksjonene.

Gitmike-témaet: de anbefaler å klone repoet deres direkte

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

Linjen vil lagre det klonede prosjektet a riktig mappe public/themes

Boční panel Skjul: Samme prosedyre kan brukes på utvidelser. Denne krever ingenting annet enn å plassere den klonede mappen a utvidelsesmappen

RUN git klon https://gitlab.com/bdemirkir/sidebar_hide.git pluginy / sidebar_hide

Vložit obrázek schránky: Dette virker også jsem typiske prosedyren, klon repoet og du er klar til å gå

RUN git klon https://github.com/RubyClickAP/clipboard_image_paste.git pluginy / clipboard_image_paste

Muži hvis du leser litt mer vil du se at "det anbefales å installere RMagick-gem, ellers vil vedlagte bilder ikke vises i eksporterte PDF-filer". Máte rádi? Det burde være jako enkelt som

RUN gem nainstalovat rmagick

men du vet sannsynligvis at gem må bygges før det kan installeres, så du må installere noen pakker før du installerer gem. Linjen du virkelig trenger er

SPUSTÍTE apt install -y build-essential imagemagick libmagickcore-dev libmagickwand-dev ruby-dev \

       && gem install rmagick

Alt i en kommando, delt i to linjer pro lesbarhet.

Den opprinnelige forfatteren av den utvidelsen gir ikke en versjon for Redmine 4, men en søk a utvidelsesnavnet på GitHub førte meg til and prosject some gjør det: RubyClickAP / clipboard_image_paste.


Legge til en utvidelse eller et tema fra en nedlastet kilde

A1-témaet er et godt eksempel for å illustrere tilfellene der du har kilden, men ikke en URL å laste ned under byggeprosessen. Ett alternativ i like tilfeller er å gi kilden til byggeprosessen. Naplánovat si dovolenou

KOPIE a1 veřejné / témata / a1

Dette krever at a1-mappen er på samme sted som Dockerfilen.

Nå er du klar til å bygge bildet ditt, så åpne en terminal der Dockerfilen din er og kjør

stavitel doku -t můj-redmine.

Når det er bygget, kan du kjøre bildet med

docker run -it -p 3000: 3000 - jméno my-redmine my-redmine

Podívejte se a podívejte se na http://localhost:3000 pro Redmine!

Redmine a tilpasning


Žádné tipy pro å legge til flere utvidelser

Pro å å pøve ut nye utvidelser er det alltid beddre å bruke en ny Redmine-container. Det er slik jeg oppdaget at rmagick krever at noen pakker blir installert. První kjør a kastelové okamžiky od Redmine med

docker run - rm -d -p 3000: 3000 - jméno test-redmine redmine

og deretter gå inn i instansen med

docker exec -it test -redmine bash

Jako instalační balíček OS, drahokamy nebo jiné migrující nástroje. Bare husk trinnene slik at du kan legge dem til Dockerfilen din!


Poslední opp ditt egendefinerte picture to Docker Hub

Bildet du nettopp bygget er kun tilgjengelig i ditt locale miljø. Hva om du ønsker å gjøre det tilgjengelig for andre, la oss si for alle? Selvfølgelig kan du laste opp Dockerfilen a related filer til et git-repo, og de interesserte kan bygge bildet self. Muži Docker lar deg også laste opp det bygde bildet til deres register. Chcete-li získat více informací, přejděte na stránku hub.docker.com a na úložiště pro obrázky. Deretter logger du inn i terminalen slik

přihlášení do doku

Merk bildet ditt slik at det kan lastes opp til ditt repo

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

og push det slik

dokovací push lcofre / redmine: nejnovější

Docker-bildet a Docker-register

Nå kan hvem jsem helst prøve ut bildet ditt ved å gjøre

docker run -it -p 3000: 3000 - jméno my-redmine lcofre / redmine

Det er det! Stáhněte si standardní instalaci Redmine, dokud se nejedná o přístup k registraci v Dockeru. Vennligst del dine komentarer eller spørsmål nedenfor.


Redusere størrelsen na Docker-bildet

Du vil oppdage at Dockerfilen a repoet har slått sammen mange linjer til én. Odhalit od Docker pro å lage mindre bilder. Du kan finne den anbefalingen og andre på https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

Annen anbefaling for å redusere den endelige størrelsen on bildet er å bruke alpine-versjonen av Redmine

FRA Redmine:alpine

Alpine je nová linuxová distribuce. I pro å bruke apt pro å installere pakker, må du bruke apk.

Et siste tipy: paktee vi installerte med apt a Dockerfilen er ikke longer nodvendige ettter at bildet er bygget. Můžete se těšit na nejlepší praxi v případě flertrinnsbygg: https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#use-multi-stage-builds

Praksis med å holde et lite Docker-bilde er spesielt nyttig når antallet instanser skal skaleres opp, men det reduserer også angrepsflaten på bildet ditt.

Den konečný Redmine-oppgraderingen? Enkel.

Všechny kraftige verktøy pro perfektní prosjektplanlegging, -styring og -controll a jeden programvare.

Oppdag Easy Redmine

Prøv Easy Redmine a 30-dagers zdarma zkušební období

Plně funkční, SSL-beskyttet, daglige sikkerhetskopier, a din geografische plassering