このチュートリアルでは、Alibaba Cloud上のDockerコンテナでJenkinsを設定します。
本ブログは英語版からの翻訳です。オリジナルはこちらからご確認いただけます。一部機械翻訳を使用しております。翻訳の間違いがありましたら、ご指摘いただけると幸いです。
#必要条件
-Ubuntu 18.04 以上がインストールされた Alibaba Cloud ECS インスタンス上で動作する仮想マシン。
-信頼できるインターネット接続。
-管理者権限を持つコンピュータ。
#仮想マシンへのDockerのインストール
最初のステップは、ホストマシンにDockerが適切にインストールされていることを確認することです。Dockerがインストールされていることを確認するには、ご使用のマシンで以下の手順に従ってください。
1.パッケージのローカルリポジトリを更新します。
$ sudo apt-get update
2.HTTPSで暗号化されたパッケージをダウンロードできるようにするためのapt-transport-https、Dockerイメージをダウンロードしてインストールしようとするときにセキュリティ証明書をダウンロードできるようにするためのca-certificates、リモートのhttpエンドポイントを照会できるようにするためのcurl、Dockerをインストールするために必要なパッケージであるgnupg-agentとsoftware-properties-agentをインストールします。
$ sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent Software-properties-common
3.Dockerのoffcial PGPキーを追加します。これは、dockerのレジストリとの通信が暗号化されて安全な状態を維持できるようにするためです。以下のコマンドで行うことができます。
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
4.Dockerの安定版リポジトリを設定します。
$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) Stable”
5.aptパッケージのインデックスを更新します。
$ sudo apt-get update
6.最新版のDockerエンジンとdocker-composeをインストールします。
$ sudo apt-get install docker docker-compose
7.以下のコマンドを実行して、Dockerが正しくインストールされていることを確認します。
$ sudo docker run hello-world
このコマンドは、docker用のテストイメージをダウンロードし、そのイメージを実行します。操作が完全に成功すると、下の画像のようなイメージが送られてくるはずです。
#DockerリポジトリからJenkinsのDockerイメージを取得する
Dockerリポジトリには、Jenkins、Jira、Java、NodeJSなど、さまざまなソフトウェアのイメージが格納されています。Jenkinsの場合、コンテナ化された環境でJenkinsを実行できるようにするためには、JenkinsのDockerイメージを公式のDockerリポジトリからダウンロードする必要があります。そこで、自分でイメージを構築するのではなく、Dockerのレジストリからイメージを引っ張ってきて、インストールしてローカルで実行することにします。
1.docker pullコマンドを実行してJenkinsのイメージを取得します。
$ docker pull jenkins
このコマンドを実行すると、シェルに似たようなテキストが表示されるはずです。
2.pullコマンドが正常に完了したことを確認するには、ターミナルでdocker imagesコマンドを実行して、jenkins imagesが既にリストアップされていることを確認します。
$ docker images
このコマンドを実行すると、ローカルにインストールされているJenkinsイメージを明確に識別できるように、ターミナルにこのようなプリントが表示されるはずです。
#DockerコンテナでJenkinsを実行する
先ほどのコマンドを実行することで、Dockerを設定し、Jenkinsのdockerイメージをローカルコンピュータにインストールしました。今度はインストール済みのjenkinsのイメージを使って、dockerイメージの中で実行してみましょう。
1.docker psコマンドを入力して、jenkinsのdockerイメージがまだ実行されていないか確認します。
$ docker ps
ターミナルでこのコマンドを実行すると、このような出力が得られるはずです。
上の画像では、MySQLとwordpressのdockerイメージが動いているのがわかりますが、Jenkinsのイメージはありません。
Jenkinsのdockerイメージは既にあります。しかし、このイメージをコンテナで動かすためには、Jenkinsのdockerのイメージをビルドして実行する必要があります。
2.Jenkinsのdockerのイメージを実行するには、以下のコマンドを実行する必要があります。
$ docker run -p 8080:8080 -p 50000:50000 jenkins/jenkins:lts
上記のコマンドでコンテナ内でJenkinsを実行し、localhostの8080番ポートで利用できるようにします。
注意: 上記のコマンドはJenkinsに永続的なストレージを提供していないため、コンテナが停止したり削除されたりすると、すべてのデータが削除されてしまいます。しかし、本番環境では、そのようなことが起きないようにしたいものです。そのような動作を避けるために、dockerインスタンスにストレージデバイスをアタッチします。
Docker はボリュームを提供しており、これにより docker コンテナにストレージを追加することができます。
3.以下のコマンドを実行して、コンテナの停止や削除時にデータを失わずにJenkinsを実行します。
$ docker run -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts
このコマンドを実行すると、以下のパスにもjenkinsフォルダが作成されます。
$ /var/jenkins_home jenkins/
4.jenkins用のdockerコンテナが作成されている間に、jenkinsはまた、以下のようにターミナルで見つけることができるパスワードを自動的に生成するか、またはファイルの中で見つけたファイルの中で見つけることができます。
$ /var/jenkins_home/secrets/initialAdminPassword
以下は、initialAdminPasswordファイルの内容のサンプルの画面キャプチャです。
注：パスワードはそこに表示されているものとは異なります。パスワードを知っておく必要があります。端末のパスポートをコピーしておくと後で使えるようになります。
5.ブラウザからJenkinsにアクセスする これを行うには、localhost:8080というアドレスでブラウザを開くと、以下のようなWebページが表示されるはずです。
6.ターミナルからコピーした管理者パスワードを入力するか、/var/jenkins_home/secrets/initialAdminPassword ファイルから取得すると、インストールページに移動します。
7.次に、プラグインを直接インストールする場合は「Install suggested plugins」を、特定のJenkinsプラグインをインストールしたい場合は「Select plugins to install」をクリックします。7.次に、目的のプラグインを選択してインストールをクリックします。
8.インストールプロセスは、あなたが最初の管理者ユーザーを作成するページにリダイレクトされ、その後、いくつかの時間がかかることができます。
9.別の管理者ユーザーを作成するか、Jenkinsで作成した管理者ユーザーを継続するかを選択しました。ここでは、デフォルトの管理者ユーザーをそのまま継続します。Continue as adminボタンをクリックします。その後、以下のような設定画面が表示されます。
これらのデフォルト設定を変更する必要はありませんが、「保存して終了」ボタンをクリックするだけで、これらの設定を保存することができます。
10.その後，最後の設定ページに移動し，Jenkinsへのログインに使用する資格情報を教えてくれます。ここでは、adminをデフォルトのユーザ名とし、 initialPasswordファイルからコピーした管理者パスワードを管理者パスワードとしたページの例を示します。
11.次に、Start Using Jenkinsをクリックするだけで、Jenkinsダッシュボードに移動します。そこでは実行するJenkinsジョブを作成することができます。以下はJenkinsのダッシュボードの画面キャプチャです。
#結論
これでこのチュートリアルは終了です。今回のチュートリアルでは、Ubuntuを実行しているLinux仮想マシンにdockerをインストールして設定する方法、Jenkins Imageをインストールして設定する方法、そしてコンテナ化された仮想マシン内で実行する方法を学びました。
アリババクラウドは日本に２つのデータセンターを有し、世界で60を超えるアベラビリティーゾーンを有するアジア太平洋地域No.1(2019ガートナー)のクラウドインフラ事業者です。
アリババクラウドの詳細は、こちらからご覧ください。
アリババクラウドジャパン公式ページ