[[410303]]

I. 概要

GitLabは、Ruby on Railsを使用して開発されたオープンソースアプリケーションです。公開プロジェクトまたは非公開プロジェクト用のセルフホスト型Gitリポジトリを提供し、Webインターフェースからアクセスできます。GitHubと同様の機能を備えており、ソースコードの閲覧、バグやコメントの管理、リポジトリへのチームアクセス管理、コミットの簡単な閲覧、ファイル履歴へのアクセスが可能です。チームメンバーは、組み込みのシンプルなチャットアプリケーション（Wall）を使用してコミュニケーションを取ることができます。また、コードスニペット収集機能も備えており、必要に応じてコードを簡単に再利用・取得できます。

II. 展開環境の説明

この記事では、展開とテストにローカル VM 仮想マシンを使用します。

OS: CentOS 7.8 x64

IP: 192.168.168.100

仮想マシン構成: 2コアCPU、4GB RAM

注: システムは最小限のインストールであり、展開前にシステムの初期化、カーネルお​​よびセキュリティの最適化が完了しています。

公式ドキュメント:

https://doc.gitlab.cc/オムニバス/

推奨されるインストール方法：公式Linuxパッケージ。Linuxパッケージはインストールが高速で、アップグレードも容易で、他の方法では利用できない高度な信頼性機能を備えています。GitLabの実行に必要な様々なサービスとツールをすべてバンドルした単一のパッケージ（Omnibusとも呼ばれます）でインストールされます。4GB以上のメモリを推奨します。

III. 基本的な依存関係

1. 依存関係をインストールする

yum -y インストール curl policycoreutils-python openssh-server perl

2. ファイアウォールの設定

CentOS 7はデフォルトでファイアウォールを使用します。この記事ではファイアウォールを無効にし、代わりにiptablesを使用します。以降の設定では必要に応じてポートが開かれます。

3. Postfix をインストールします（通常、CentOS 7 システムにプリインストールされています）

通知メールを送信するにはPostfixを使用してください。別の方法でメールを送信する場合は、この手順をスキップし、GitLabをインストールした後に外部SMTPサーバーを設定してください。

 yum -y postfix をインストール
systemctl で postfix を有効にする
systemctl postfix を起動する

IV. YUMを使ったGitLabのインストール

1. GitLabパッケージリポジトリを追加する

方法1: 公式YUMリポジトリを使用する

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | bash

方法2：国内のYUMリポジトリを使用する

## 新しいREPOファイルを作成する

vi /etc/yum.repos.d/gitlab-ce.repo
 //次のコンテンツを追加します
[gitlab-ce]
 name = Gitlab CE リポジトリ
ベースURL=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/
 gpgcheck=0
有効=1

## ローカルのyumキャッシュを更新する

yum makecache 高速

2. インストール

## 最新バージョンをインストールする

yum -y で gitlab-ce をインストールします

下の画像のようにインストールが完了します。

上記の画像は、GitLabがインスタンスの有効なホスト名を検出できないことを示しています。/etc/gitlab/gitlab.rbファイルの「external_url」設定項目を設定して、GitLabインスタンスのURLを設定してください。

## 指定されたバージョンをインストールする

yum -y gitlab-ce-xxx をインストールします
//xxxはバージョン番号を表します

V. RPMパッケージ経由でGitLabをインストールする

リポジトリ経由でGitLabをインストールするのが不安な場合は、RPMパッケージをダウンロードしてインストールできます。RPMパッケージには必要なソフトウェアがすべて統合されているため、インストールプロセスが簡素化されます。

公式 RPM パッケージ アドレス:

https://packages.gitlab.com/gitlab/gitlab-ce

国内RPMパッケージアドレス:

https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/

 cd /data/tools
 https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-14.0.3-ce.0.el7.x86_64.rpm を実行します
rpm -ivh gitlab-ce-14.0.3-ce.0.el7.x86_64.rpm

下の画像のようにインストールが完了します。

上記の画像は、GitLabがインスタンスの有効なホスト名を検出できないことを示しています。/etc/gitlab/gitlab.rbファイルの「external_url」設定項目を設定して、GitLabインスタンスのURLを設定してください。

VI. GitLabの設定

1. gitlab.rb の設定を変更してください。

## external_url を設定して、リスニングドメイン名またはIPポートをバインドします。GitLabにパブリックネットワーク経由でアクセスする必要がある場合は、ドメイン名をHTTPSで設定するのが最適です。内部ネットワーク経由でアクセスする場合は、IPアドレスとポートを設定するか、ドメイン名のみを設定して、ユーザーがローカルのhostsファイル経由でアクセスできるようにします。

この記事はテスト目的であり、IPアドレスとポート番号（例：http://192.168.168.100:90）を使用します。ポート番号は使用されていない必要があります。デフォルトはポート80です。ポート80が既に使用されている場合は、別のポートをカスタマイズし、ファイアウォール設定で対応するポートを開くことができます。

 /etc/gitlab/gitlab.rb を vi で開きます

2. 構成をロードする

gitlab-ctl の再構成
//最初の設定には長い時間がかかる場合がありますので、しばらくお待ちください。

注意： ① デフォルトの管理者アカウントのユーザー名はrootで、パスワードは[場所不明]に保存されます。

ファイル /etc/gitlab/initial_root_password は、24 時間後の最初の再構成実行時にクリアされます。

② 必要がない限り、2回目の初期化は推奨されません。後で設定ファイルを変更する場合は、gitlab-ctl restartコマンドを使用してすべてのコンポーネントサービスを再起動し、新しい設定を有効にしてください。

③ まず、gitlab.rbファイル内の「external_url」オプションの値を変更し、「gitlab-ctl reconfigure」コマンドを使用してGitLabの設定を行います。これにより、設定後に値を変更する必要がなくなります。

ファイル「/var/opt/gitlab/gitlab-rails/etc/gitlab.yml」の「Web サーバー設定」の値は、次の画像に示されています。

変更の必要もありません。

ファイル「/var/opt/gitlab/nginx/conf/gitlab-http.conf」の「server」オプションの「listen」と「server_name」の値は、次の画像に示されています。

VII. テストアクセス

## [場所が不明] に保存されている初期管理者アカウントのパスワードを表示します。

この記事で管理者アカウント用に生成されるパスワードは、w8HgJZJd2+USFDwKxQWqRO2FWUQjE9UfBUFbLx3kfRM= (/etc/gitlab/initial_root_password 内のファイル) です。

ブラウザのアドレスバーに「http://ip:port/」（この場合はhttp://192.168.168.100:90）と入力してください。サーバーのiptablesファイアウォールはすでにポート90を開いています。

## 初期管理者アカウントを入力します: root パスワード: XGi+u+5Z3Nga/lLK+

fgpxTuTOADzHd9h9vWmquUU4cQ= 、ログインしてください。

## ログイン成功後のホームページ。

## 次に、GitLab を使用できますが、この記事では詳しく説明しません。

8.管理者パスワードを変更する

管理者アカウントのルート パスワードは初期化時にデフォルトで生成されます。最初のログイン後に変更することをお勧めします。

方法1:

## 下の画像に示すように、ホームページの左上隅にある「メニュー」→「管理者」をクリックします。

左側のサイドバーで「概要」→「ユーザー」に移動します。右側のページに現在のユーザーが表示されます。新規にインストールしてデプロイしたGitLabインスタンスには、管理者アカウントが1つだけあります。管理者アカウント情報セクションの最後にある「編集」をクリックします。下の画像をご覧ください。

## 編集ページの「パスワード」オプションに新しいパスワードを 2 回入力し、ページの下部にある「変更を保存」をクリックして変更を保存します。

方法2:

## ホームページの右上隅にある管理者アカウントのアバターをクリックし、「プロフィールの編集」をクリックします（下の画像を参照）。

左側のサイドバーにある「パスワード」をクリックし、管理者アカウントの現在のパスワードと新しいパスワードを右側のページに2回入力し、「パスワードを保存」をクリックして変更を保存します。下の画像をご覧ください。

方法3:

Rails コンソール経由で管理者アカウントのパスワードをリセットします。

Railsコンソールの公式ドキュメント:

https://docs.gitlab.com/ce/administration/operations/rails_console.html

GitLab アプリケーションが配置されているサーバーにログインし、次のコマンドを実行します。

## YUM リポジトリまたは RPM パッケージを使用した Rails インストールの場合は、次のコマンドを使用して Rails コンソールに接続します。

 GitLab Railsコンソール

## パスワードをリセットするには次のコマンドを使用します

ユーザー=ユーザー.最初 
 //スーパー管理者に切り替えます。ID 1 のユーザーがスーパー管理者です。
ユーザー.パスワード= '新しいパスワード'  
 //パスワードは8文字以上である必要があります。ここでの新しいパスワードは「yourNewpassword」です。  
ユーザー.save!
 // 問題がなければ「true」を返します。  

## 変更が完了したら、quit または exit と入力して Rails コンソールを終了します。

方法4:

Rake タスクを使用して管理者アカウントのパスワードをリセットします。

公式ドキュメント:

https://docs.gitlab.com/ce/security/reset_user_password.html

GitLab アプリケーションが配置されているサーバーにログインし、次のコマンドを実行します。

 gitlab-rake "gitlab:password:reset"  
 //管理者アカウントと新しいパスワードを2回入力します

IX. よく使われるGitLabコマンド

## GitLab を設定する
gitlab-ctl の再構成
## すべてのGitLabコンポーネントを起動する
gitlab-ctl スタート
## すべてのGitLabコンポーネントを停止する
gitlab-ctl 停止
## すべてのGitLabコンポーネントを再起動します
gitlab-ctl を再起動する
## サービスステータスを確認する
gitlab-ctl ステータス
## GitLabをチェックする
gitlab-rake gitlab: SANITIZE= true をチェック  - トレース 
 ## ログを表示
gitlab-ctl テール

[編集者のおすすめ]

1. 話題沸騰中！ビリビリ動画のクリエイターがAIを駆使し、李大昭、陳延年らを笑顔に！
2. ネットワークエンジニア必読！IPアドレス、サブネットマスク、ゲートウェイをわかりやすく解説！
3. Microsoft Windows 11 では、シャットダウンして再起動するときに推定の「更新時間」が追加されます。
4. Windows 11にはInternet Explorerがなくなりました。EdgeでIEモードを有効にする方法をご紹介します。
5. Windows 11 プレビュー版が突如登場！Windows 11 を垣間見れる高解像度画像を多数収録。