EC2 AmazonLinux2 にGitLabをインストールする

7366 ワード

AmazonLinux EC2 AWS GitLab AmazonLinux2 AWS テキストリンク

デザイナーさんと共同でHTML/CSSを作ることになったので、資材管理のためにAWSのEC2にGitLabをインストールしました。手順を纏めておきます。

なお、GitLabだけ動かせばよかったので、Dockerなどは使わずにインスタンスに直接インストールしました。所要時間は20分程度です。

作業環境

macOS BigSur 11.0.1

参考

セルフマネージドGitLabをインストール | GitLab公式サイト
 GitLabをAWS上で動かす(3/3) | Qiita
AmazonEC2にGitLab CEの環境を構築する | かつおぶしのブログ
 docker-composeを使ってgitlabを構築する | mebee

手順

インスタンスを作る
インバウンドの設定で HTML を追加しておく
インスタンスにsshで接続する
GitLabや必要なパッケージをインストール
初期設定
ブラウザからアクセスできるか確認する

インスタンスを作る

t2.micro（メモリ2GB）にインストールを試みたところ、インストールの途中で固まりました（通信が切れたけどインストールはできていたことが後から分かった）。
そこで、メモリが4GBの t3.midium で作り直しました。

ちなみに、GitLabの公式ページではメモリ4GB以上の環境が推奨されています。目立つところに記載されていたので、恐らく同じようにコケる人が多いのではないでしょうか？

インスタンスの仕様は下記の通りです。

タイプ：t3.midium
ストレージ：50GB
OS：AmazonLinux2

インバウンドの設定で HTML を追加しておく

ブラウザからアクセスするのにインバウンドルールにHTMLを追加する必要があります。設定を忘れてアクセスできなくて悩んだことがあるので先に設定しておきます。
（セキュリティの観点から、すぐにインストールの作業をしない時は作業をする直前に設定するようにします。）

インスタンスにsshで接続する

インスタンスを作成する時に新しくキーバリューのキーを作成した時は、chmod でパーミッション（権限）を 400 を設定しないとエラーになります。（忘れてよくエラーを出します）

パーミッションの 400 は所有者のみに読み込みが許可される権限です。所有者以外は読み込みできませんし、所有者も含め変更削除は行えません。

# ファイルのパーミッションを400に設定
$ chmod 400 xxxxxxxx/xxxxxx/hoge-key.pem

sshで接続します。ユーザー名はデフォルトの ec2-user を指定します（これも久しぶりだと忘れて悩むことがある）。

コマンドは ssh -i <キーの絶対パス> ec2-user@<インスタンスのグローバルIP>です。

# sshでインスタンスに接続
$ ssh -i ~/xxxxxx/xxxxx/hoge-key.pem [email protected]

# 途中でYesかNoか聞かれた場合は　y を入力してEnter

〜略〜
       __|  __|_  )
       _|  (     /   Amazon Linux 2 AMI
      ___|\___|___|

https://aws.amazon.com/amazon-linux-2/

GitLabや必要なパッケージをインストール

CentOS7だとpostfixのインストールが必要らしいですが、下記の通り、AmazonLinux2の場合は最初からインストールされていました。

# postfixをインストール（AmazonLinux2の場合は不要だった）
$ sudo yum install postfix

読み込んだプラグイン:extras_suggestions, langpacks, priorities, update-motd
amzn2-core                                               | 3.7 kB     00:00     
パッケージ 2:postfix-2.10.1-6.amzn2.0.3.x86_64 はインストール済みか最新バージョンです
何もしません

念の為 postfix の有効化と起動のコマンドは実行しておきます。

# postfixの有効化
$ sudo systemctl enable postfix
# postfixを起動
$ sudo systemctl start postfix

次に、GitLabのパッケージをリポジトリに追加します。パッケージのURLは　セルフマネージドGitLabをインストール - GitLab公式サイト　にあるのが最新のはずなので、確認してください。

# GitLabのパッケージをリポジトリに追加
$ curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash

The repository is setup! You can now install packages.
と表示されたらOK

次に、GitLabのパッケージをインストールします。下のコマンドの
EXTERNAL_URL="https://gitlab.example.com"の部分はブラウザでアクセスする際のアドレスを指定します。アドレスは後で設定できるので指定しなくても問題ないです。

# GitLabのパッケージをインストール
$ sudo EXTERNAL_URL="https://gitlab.example.com" yum install -y gitlab-ee

EXTERNAL_URLを後で設定する場合は、sudo yum install -y gitlab-eeだけです。

下記のように、「完了しました！」と表示されたらインストールOKです。

〜〜〜略〜〜〜
インストール:
  gitlab-ee.x86_64 0:13.6.1-ee.0.el6                                            

依存性関連をインストールしました:
  audit-libs-python.x86_64 0:2.8.1-3.amzn2.1                                    
  checkpolicy.x86_64 0:2.5-6.amzn2                                              
  libcgroup.x86_64 0:0.41-21.amzn2                                              
  libselinux-python.x86_64 0:2.5-12.amzn2.0.2                                   
  libsemanage-python.x86_64 0:2.5-11.amzn2                                      
  policycoreutils-python.x86_64 0:2.5-22.amzn2                                  
  python-IPy.noarch 0:0.75-6.amzn2.0.1                                          
  setools-libs.x86_64 0:3.3.8-2.amzn2.0.2                                       

完了しました!

初期設定

gitlab.rb をvimで開いてブラウザからアクセスする際のURLを設定します。インストールの時にEXTERNAL_URL=""でURLを指定した場合も念のため確認しておいた方が良いと思います。

# gitlab.rbを開く
$ vi /etc/gitlab/gitlab.rb

external_urlが設定されている場所が分かりにくいので、/とかを使って検索した方が楽です。

ブラウザからhttpでアクセスする場合、external_url はhttp://<インスタンスのグローバルIP>になります。IPの後ろに"/"で区切ってアドレスを追加することができるので、同じインスタンスに他のツールをインストールする場合は http://<インスタンスのグローバルIP>/gitlabとかにすると良いかもしれません。

# エディターでexternal_urlを設定
external_url 'http://xxx.xxx.xxx.xxx/gitlab'

設定を保存したら、GitLabを再起動します。

# gitを再起動
$ sudo gitlab-ctl reconfigure

gitlab Reconfigured!と表示されたらOKです。

ブラウザからアクセスできるか確認する

ブラウザへ external_url　に設定したURLを入力してアクセスします。最初に開くとこんな感じの画面が表示されます。ここで管理者（root）のパスワードを設定します。

パスワードを設定したらサインインの画面が表示されます。
Username はデフォルトでroot、Passwordは先ほど設定したパスワードです。

サインインできました。

その他の設定

デフォルトは英語です。日本語する場合はユーザーの設定ページから変更できます（ユーザー毎に設定する仕様になっています）

こちらのサイトを参考にさせていただきました。
docker-composeを使ってgitlabを構築する | mebee

以上です。

Author And Source

この問題について(EC2 AmazonLinux2 にGitLabをインストールする), 我々は、より多くの情報をここで見つけました https://qiita.com/Ajyarimochi/items/9dcaba108fb1bce3f019

著者帰属：元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。

Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .