[RUBY] GitLab Development Environment Setup (GDK) unter macOS (September 2020)

** tl; dr: ** Bereiten Sie eine Umgebung für die Entwicklung von GitLab selbst (Web UI, API) in einer macOS-Umgebung vor.

Jedes Jahr wird ein Setup-Artikel für die Entwicklungsumgebung der integrierten DevOps-Plattform GitLab erstellt. Ich werde ihn jedoch unter der Annahme beschreiben, dass es sich um die neueste Version handelt, die auf Qiita auf Japanisch angezeigt werden kann.

Annahme

macOS: Angenommen 10.13, 10.14, 10.15. Personen mit 10.15 können Zsh sein. MacBook Pro (Retina oder höher) wird bevorzugt, scheint jedoch mit MacBook / MacBook Air zu funktionieren. Ich habe es mit dem MacBook Pro (Retina, 13 Zoll, Mitte 2014) i5 2 Core 8 GB Speicher, 128 GB SSD (freier Speicherplatz 20 GB) bestätigt.

Angenommen, GitLab-Community-Mitglieder (dh alle).

Warum schreiben?

Der GitLab Hackathon 3Q 2020 findet am 2020-09-02 / 2020-09-03 auf Japanisch statt https://gitlab-jp.connpass.com/event/187652/ https://gitlab-jp.connpass.com / event / 187244 / https://gitlab-jp.connpass.com/event/187246/ Ich hatte den Vorsitz und ~~ fast ~~ alle Teilnehmer waren süchtig danach, also Letzter Tag Tag 2 Schreiben Sie in Eile rechtzeitig für (: //gitlab-jp.connpass.com/event/187246/).

Es scheint, dass die Leute von Inc. vor ein paar Wochen bezahlt und korrigiert wurden, aber ich schreibe es, weil es zu schlecht ist (es war in der Vergangenheit in einem etwas schlechten Zustand, aber mit mehr Schwung).

Für diesen Artikel gibt es keine Finanzierung. Korrekturanfragen sind willkommen. Dieser Artikel wird von GitLab B.V., GitLab Inc. und einem oder mehreren verbundenen Unternehmen nicht bereitgestellt oder finanziell unterstützt.

Dieser Artikel ist keine Werbung für GitLab Hackathon 3Q '2020 auf Japanisch.

Voraussetzungen

Bitte sichern Sie mindestens 15 GB freien Speicherplatz auf der SSD. Die meisten Leute (sehen Sie, ob sie dasselbe in der Vergangenheit installiert haben) verbrauchen ungefähr 10 GB.

Vorbereitungen (18 Minuten)

Fortschritt 1. Homebrew hinzufügen (5 Minuten)

Was die früheren Teilnehmer betrifft, gibt es viele Leute, die es aufgenommen haben, daher möchte ich es weglassen, aber wenn es Leute gibt, die es nicht aufgenommen haben, ist es unter https://brew.sh/index_ja geschrieben. Bitte lesen Sie es.

Pre 2. Legen Sie abhängige Pakete mit Homebrew ein (2 Minuten).

Führen Sie die folgenden Schritte aus, um die abhängigen Pakete einzuschließen: Ich erinnere mich, dass in der Vergangenheit nur wenige Menschen von der lokalen Veranstaltung GitLab Hackathon Japan abhängig waren, die von GitLab Tokyo veranstaltet wurde.

brew install asdf git git-lfs libiconv pkg-config cmake openssl coreutils re2 graphicsmagick gpg icu4c exiftool sqlite
brew link pkg-config
brew pin libffi icu4c readline re2
if [ ${ZSH_VERSION} ]; then shell_file="${HOME}/.zshrc"; else shell_file="${HOME}/.bash_profile"; fi
echo 'export PKG_CONFIG_PATH="/usr/local/opt/icu4c/lib/pkgconfig:$PKG_CONFIG_PATH"' >> ${shell_file}
source ${shell_file}
brew cask install google-chrome chromedriver

Vorläufig 3. Reflektieren Sie die asdf-Einstellungen in der Shell (1 Minute).

macOS 10.15 and Zsh

Starten Sie das Terminal anschließend neu.

echo -e "\n. $(brew --prefix asdf)/asdf.sh" >> ~/.zshrc

macOS 10.14 or Bash

Starten Sie das Terminal anschließend neu.

echo -e "\n. $(brew --prefix asdf)/asdf.sh" >> ~/.bash_profile
echo -e "\n. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash" >> ~/.bash_profile

Vorher 4. Installieren Sie Ruby (10 Minuten)

Wir verwenden ein Paketverwaltungstool namens asdf.

Aktivieren Sie Ruby mit asdf mit dem folgenden Befehl.

asdf plugin add ruby

Installieren Sie den erforderlichen Ruby 2.6.6 mit dem folgenden Befehl. Es nimmt viel Zeit in Anspruch, da es aus dem Quellcode kompiliert wird.

asdf install ruby 2.6.6

Verwenden Sie den folgenden Befehl, um Ruby 2.6.6 mit asdf in einem beliebigen Verzeichnis verfügbar zu machen.

asdf global ruby 2.6.6

GDK Installation und Konfiguration (22 Minuten)

Setup 1. Installieren Sie das Gitlab-Development-Kit Gem (1 Minute).

Installieren Sie Gem mit dem folgenden Befehl.

gem install -N gitlab-development-kit

Verwenden Sie nicht "sudo".

Setup 2. GDK-Grundeinstellung (1 Minute)

Erstellen Sie ein Arbeitsverzeichnis mit dem folgenden Befehl.

gdk init

Setup 3. Laden Sie Abhängigkeiten in das GDK-Arbeitsverzeichnis herunter und konfigurieren Sie sie (10 Minuten).

Verwenden Sie den folgenden Befehl, um zum GDK-Arbeitsverzeichnis zu wechseln.

cd gitlab-development

Verwenden Sie die folgenden zwei Befehle, um Node.js von asdf aus zu aktivieren.

asdf plugin-add nodejs https://github.com/asdf-vm/asdf-nodejs.git
bash -c '${ASDF_DATA_DIR:=$HOME/.asdf}/plugins/nodejs/bin/import-release-team-keyring'

Rufen Sie die anderen abhängigen Bibliotheken mit dem folgenden Befehl ab:

make bootstrap

Verwenden Sie den folgenden Befehl, um den PostgreSQL Gem-Build zu konfigurieren.

bundle config build.pg --with-opt-dir="${HOME}/.asdf/installs/postgres/11.8"

Setup 4. Quellcode herunterladen (10 Minuten)

Laden Sie den Quellcode für mehrere Repositorys mit dem folgenden Befehl herunter.

gdk install shallow_clone=true

Bestätigung (6 Minuten)

Bestätigung 1. Starten Sie GDK (1 Minute)

Starten Sie GitLab mit dem folgenden Befehl. Das erste Mal

gdk start

Bestätigung 2. Bestätigen Sie mit dem Webbrowser (5 Minuten)

Geben Sie "http: // localhost: 3000" in die Adressleiste Ihres Browsers ein oder öffnen Sie sie mit dem folgenden Befehl: Ein 502-Fehler wird bis zur ersten Anzeige angezeigt, und es dauert ungefähr 5 Minuten, bis eine normale Seite angezeigt wird. Während Sie warten, werfen Sie einen Blick auf den Bonusabschnitt unten.

open http://localhost:3000/

Wenn dies angezeigt wird, ist es OK.

Da alle Arbeiten in der Befehlszeile ausgeführt werden, ist dies ein Bereich. Wenn dieser Bildschirm angezeigt wird, können Sie ihn entwickeln.

Bonus

Wenn Sie bei GitLab.com angemeldet sind, gehen Sie zu https://gitlab.com/gitlab-org/gitlab und drücken Sie die Gabel-Taste, um in Ihre Region zu klonen. Ersetzen Sie dann "[YOUR-NAMESPACE]" durch Ihren GitLab-Kontonamen und führen Sie den folgenden Befehl aus:

git remote set-url [email protected]:[YOUR-NAMESPACE]/gitlab.git
support/set-gitlab-upstream