Jak stworzyć własny obraz Redmine w Dockerze.

Redmine przed dostosowaniem

Vigyázat: Redmine natywny docker można znaleźć na https://hub.docker.com/_/redmine. Tutaj można również znaleźć dobre instrukcje dotyczące sposobu wypełnienia zewnętrznej bazy danych i zamontowania zewnętrznych folderów (aby móc zainstalować wtyczki).

Jeśli jesteś jak ja i wolisz bezpośrednio zobaczyć kod do budowania niestandardowego obrazu Redmine Docker, możesz przejść do github.com/lcofre/redmine i sprawdzić plik Dockerfile.

Obraz Docker Redmine jest dobrym punktem wyjścia, chociaż prawdopodobnie chciałbyś go dostosować do swoich upodobań za pomocą wtyczek i motywów. W tym poradniku zbudujemy obraz Docker na podstawie oficjalnego, dodamy kilka motywów i wtyczek oraz wgrajmy go do rejestru docker.

Dla uproszczenia nie będziemy korzystać z zewnętrznej bazy danych, ale z wewnętrznej bazy danych w kontenerze Redmine. W środowisku produkcyjnym jednak zaleca się skonfigurowanie dedykowanego kontenera pamięci masowej.

Wtyczki i motywy

Wybraliśmy kilka wtyczek i motywów, aby zilustrować różne sposoby dodawania ich do Redmine:

• Ukryj pasek boczny, wtyczka umożliwiająca uzyskanie większej przestrzeni ekranowej, zwłaszcza podczas pisania problemów
• Wklej ze schowka, umożliwiający dołączanie zrzutów ekranu poprzez wklejanie ze schowka zamiast wybierania pliku
• A1 i Gitmike, dwa motywy zmieniające wygląd interfejsu użytkownika

Wykluczamy wtyczki, które wymagają migracji bazy danych, ponieważ potrzebna jest istniejąca baza danych. Prosimy o komentarz poniżej, jeśli potrzebujesz zainstalować wtyczkę, która wymaga migracji, ponieważ mamy dla Ciebie dobre pomysły.

Pisanie pliku Dockerfile

Kattintson a Dockerfile-re a Docker-re. Pierwszą rzeczą, którą się dowiemy, jest to, że musimy opierać nasz obraz na innym obrazie, więc użyjemy oficjalnego dla Redmine

Redmine-től

Ta pierwsza linia pliku Dockerfile opiera nasz obraz na najnowszym i najlepszym obrazie, 4.1.0 w momencie pisania. Ponieważ to pobierze najnowszą wersję, możesz wolisz użyć konkretnej wersji, aby uniknąć nieoczekiwanych nowych wersji, które mogą zepsuć budowę tego obrazu

Redmine-től: 4.1.0

Używanie Git do pobierania komponentów

W większości przypadków motywy i wtyczki mają repozytoria git, z których możemy pobrać najnowszy kod. Tak jest w przypadku następujących trzech komponentów.

Podstawowy obraz Redmine nie zawiera gita, ale możemy dodać go do obrazu w ten sposób:

RUN apt install -y GIT

To zostanie wykonane podczas budowania obrazu i umożliwi korzystanie z gita w następujących instrukcjach.

Motyw Gitmike: zalecają bezpośrednie klonowanie ich repozytorium

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

Ten wiersz zapisze sklonowany projekt w odpowiednim folderze public/themes

Ukryj pasek boczny: Ten sam proces można zastosować do wtyczek. Ta wymaga jedynie umieszczenia sklonowanego folderu w folderze wtyczek

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

Csipeszes írótábla-beillesztés: To również wydaje się typową procedurą, sklonuj repozytorium i jesteś gotowy do działania

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

Ale jeśli przeczytasz trochę więcej, zobaczysz, że "zaleca się zainstalowanie gemu RMagick, w przeciwnym razie załączone obrazy nie będą wyświetlać się w plikach PDF". Jak zrobićnak? Powinno być takie proste jak

Futtassa a gem install rmagick szoftvert

ale prawdopodobnie wiesz, że gem musi zostać zbudowany przed zainstalowaniem, więc musisz zainstalować kilka pakietów przed zainstalowaniem gemu. Wiersz, który naprawdę potrzebujesz, to

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

       && gem install rmagick

Wszystko w jednej komendzie, podzielone na dwie linie dla czytelności.

Oryginalny autor tej wtyczki nie dostarcza wersji dla Redmine 4, ale wyszukiwanie nazwy wtyczki w GitHubie skierowało mnie na projekt, który ją ma: RubyClickAP / clipboard_image_paste.

Dodawanie wtyczki lub motywu z pobranego źródła

Motyw A1 jest dobrym przykładem, aby pokazać przypadki, gdy masz źródło, ale nie masz URL do pobrania podczas procesu budowania. Jednym z rozwiązań w takich przypadkach jest dostarczenie źródła do procesu budowania. W ten sposób zawartość zostanie dodana do obrazu bez pobierania jej.

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

Wymaga to, aby folder a1 był w tym samym miejscu, co plik Dockerfile.

Teraz jesteś gotowy do zbudowania swojego obrazu, więc otwórz terminal tam, gdzie znajduje się plik Dockerfile, i wykonaj

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

Po zbudowaniu będziesz mógł uruchomić swój obraz za pomocą

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

Otwórz http://localhost:3000, aby zobaczyć swojego dostosowanego Redmine'a!

Redmine po dostosowaniu

Kilka wskazówek, jak dodać więcej wtyczek

Aby wypróbować nowe wtyczki, zawsze lepiej użyć świeżego kontenera Redmine. W ten sposób zdałem sobie sprawę, że rmagick wymaga zainstalowania niektórych pakietów. Najpierw uruchom tymczasowy kontener Redmine z

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

a następnie wejdź do kontenera za pomocą

dokkoló végrehajtja - teszt-redmine bash

Tam możesz instalować pakiety systemowe, gemy lub uruchamiać migracje. Po prostu pamiętaj o krokach, aby móc dodać je do swojego pliku Dockerfile!

Przesyłanie niestandardowego obrazu do Docker Hub

Obraz, który właśnie zbudowałeś, jest dostępny tylko w Twoim środowisku lokalnym. Co zrobić, jeśli chcesz udostępnić go innym, powiedzmy wszystkim? Oczywiście, możesz przesłać plik Dockerfile i powiązane pliki do repozytorium git, a zainteresowani będą mogli sami zbudować obraz. Ale Docker pozwala również przesłać zbudowany obraz do ich rejestru. W tym celu utwórz fiók na hub.docker.com i utwórz również repozytorium dla swojego obrazu. Następnie zaloguj się w terminalu w ten sposób:

dokkoló bejelentkezés

Oznacz swój obraz, aby można go było przesłać do Twojego repozytorium

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

i przesłać go w ten sposób

dokkoló push lcofre / redmine: legújabb

Obraz Docker w Rejestrze Docker

Teraz każdy może wypróbować Twój obraz, wykonując

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

wszystko-nak! Tak przechodzisz od standardowej instalacji Redmine do personalizowanej wersji dostępnej w rejestrze Docker. Podziel się swoimi komentarzami lub pytanami poniżej.

Zmniejszenie rozmiaru obrazu Docker

Zauważysz, że plk Dockerfile w repozytorium połączył wiele linii w jedną. Jest to zalecenie Docker, aby uzyskać mniejsze obrazy. Możesz znaleźć tę radę i inne na stronie https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

Innym zaleceniem zmniejszenia końcowego rozmiaru obrazu jest użycie wersji alpesi Redmine

Redmine-től: alpesi

Alpine to inna dystrybucja Linuxa. Zamiast używać apt do instalowania pakietów, musisz użyć apk.

Ostatnia wskazówka: paciety, które zainstalowaliśmy za pomocą apt w pliku Dockerfile, nie są już potrzebne po zbudowaniu obrazu. Możesz postępować zgodnie z najlepszą praktyką stosowania wieloetapowych budowli: https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#use-multi-stage-builds

Praktyka utrzymywania małego obrazu Docker pomaga szczególnie przy skalowaniu liczby instancji, ale także zmniejsza powierzchnię ataku na Twój obraz.