このチュートリアルでは、AnsibleとJenkinsを使用して、Tomcat、Java、MySQLで構成されたイメージをAlibaba Cloud上にデプロイします。

本ブログは英語版からの翻訳です。オリジナルはこちらからご確認いただけます。一部機械翻訳を使用しております。翻訳の間違いがありましたら、ご指摘いただけると幸いです。

前提条件

最低でも1台のJenkinsサーバが必要です(マスターのみまたはマスター/スレーブ設定の場合)。

そして、Jenkinsサーバのマスター/スレーブ(エージェント)環境を設定したら、サーバの状態を確認してエージェントが正常に稼働していることを確認します。特に私のセットアップでは、マスターノードをJenkinsサーバとして、エージェントマシンをAnsible用に使用しています。ご希望であれば、マスター自体にAnsibleをインストールすることで、1台だけのマシンを持つことも可能です。

その後、マスターマシンとエージェントマシンにAnsible Toolをインストールします。

2.Ansibleを導入します。Ansibleは、ITオートメーションのための強力なツールであり、ターゲット環境をプロビジョニングし、その上でアプリケーションをデプロイするためにCI/CDプロセスで使用することができます。しかし、Ansibleはメンテナンスが面倒で、長期的にはスクリプトを再利用してしまうことを知っておいてください。
Ansible がインストールされている集中管理された場所から、異なるサーバ/環境にまたがって同じタスクを実行する場合に役立ちます。Ansible は完全にエージェントレスであるため、Chefや Puppet のような他の IaC (Infrastructure-as-Code) ツールと比較して優位性があります。Ansible を使用すると、クライアントシステムにエージェントをインストールする必要がなく、クライアントとサーバ間の SSH 通信によって自動化が行われます。指定した地域に何百ものインスタンスがあれば、すべての自動化が容易になります。AnsibleのプレイブックはYAML/YML言語で書かれています。

Ansibleになると、以下のような知識も必要になってきます。

Control node：Ansible がインストールされており、管理しているサーバーを担当するマシン
Inventory：プレイブック内のコマンド、モジュール、タスクが動作するホストとホストグループを定義するファイル。このファイルは、Ansible 環境とプラグインに応じて多くの形式のいずれかになります。プロジェクト固有のインベントリファイルを別の場所に作成するために使用します。
Playbook：Ansible の設定、デプロイメント、オーケストレーション言語の一部。リモートシステムに適用させたいポリシーや、一連のステップを記述することができます。

Ansible と Ansible Alicloud モジュールのインストール

まず、JenkinsにAnsibleプラグインをインストールします。そのためには、以下の手順に従います。

ダッシュボードのManage Jenkinsをクリックします。

プラグインの管理をクリックして、ページの右上にある検索バーで Ansible プラグインを探します。

Ansible を選択して、Download now をクリックし、再起動後にインストールします。

注意: このチュートリアルで行っている現在のセットアップには必要のない Ansible Tower はインストールしないでください。

Jenkins に Ansible プラグインをインストールしたら、次は Client/Agent マシンに Ansible をインストールする手順に進みます。

クライアント/エージェントマシンにAnsibleをインストール

Alibaba Ansibleモジュールは頻繁に更新されているので、最新版はGitHubのリンクを参照することをお勧めします。

エージェントマシンでターミナルウィンドウを開き、以下のコマンドを実行します。

CentOS 7.4を使用している場合は、このコマンドを使用すると良いでしょう。

sudo yum check-update; sudo yum install -y gcc libffi-devel python-devel openssl-devel epel-release
sudo yum install -y python-pip python-wheel

Ubuntu 16.04 LTSを使用している場合は、このコマンドを使用します。

sudo apt-get update && sudo apt-get install -y libssl-dev libffi-dev python-dev python-pip

次のコマンドを入力して、必要なパッケージAnsible for Alibabaをインストールします。

sudo pip install ansible

sudo pip install ansible_alicloud

sudo pip install ansible_alicloud_module_utils

Ansibleプレイブックを設定

アリババECSをプロビジョニングするためのAnsibleのプレイブックスクリプトをこちらに作成してみました。ソースコードをフォークして、環境に合わせてパラメータの値を変更することができます。

    alicloud_access_key: <Alibaba Access Key>
    alicloud_secret_key: <Alibaba Secret Key>
    alicloud_region: <Alibaba Region for your resource> e.g. - ap-south-1
    alicloud_zone: <Alibaba Zone for your resource> e.g. ap-south-1a
    password: <New VM Password>
    image: "m-a2d4qmk8v2w9s5wmh0rw"

注：私はZhuyunが提供するAlibaba Application Stacksからイメージをインポートしています。こちらでご確認ください。Linux、Nginx、MySQL、Jdk-Tomcat（Nginx1.6-jdk1.7-tomcat7-mysql5.5-vsFTPd2.2.2）で構成されています。

アクセスキーとシークレットの生成

さて、アクセスキーとシークレットを生成する時が来ました。これを行うには、以下の手順に従ってください。

アクセスキーとシークレットキーを取得するには、Alibaba Cloudコンソールにアクセスして、製品メニューからリソースアクセス管理(RAM)を選択します。

左側のナビゲーションペインで［ユーザー］オプションをクリックし、［ユーザーの作成］を選択します。

新しいユーザーを作成し、ログイン名と表示名を入力します。次に、[アクセスモード]で、[プログラムアクセス]にチェックを入れます。このユーザーに Console Password Logon アクセスを提供する必要はありません。

プレイブックのalicloud_access_keyとalicloud_secret_keyの値となるAccessKeyIdとAccessKeySecretをコピーします。

注意：ダイアログボックスを閉じると、AccessKey情報は再び利用できなくなります。したがって、ダイアログボックスを閉じる前にこの情報をコピーして保存しておくことが重要です。

VPC、V-Switchs、セキュリティグループ、またはECSインスタンスのようなリソースをプロビジョニングするための適切な権限を提供します。私はAdministratorAccessを提供していますが、これはAlibaba Cloudのサービスやリソースへのフルアクセスを提供するために起こることです。

アリババクラウドの地域とゾーン

注）1.

完全なリストを取得するには、Alibaba CloudのCLIツールを使用することができます。JSONの壁を吐き出してくれるので、*nix上にいてjqツールが利用できるのも便利です。以上のことを考えると、必要なのはこの短いシェルスクリプトだけです。

#!/usr/bin/env bash

for region in $( aliyun ecs DescribeRegions | jq '.Regions.Region[].RegionId' )
do
    echo $region
    reg=$( echo $region | sed s/\"//g )
    echo '---'
    for zone in $( aliyun ecs DescribeZones --RegionId $reg | jq '.Zones.Zone[].ZoneId' | sort )
    do
        echo $zone
    done
    echo ''
done

以下の地域・ゾーンにリソースを提供したい場合は、こちらのリンクから実名登録を行ってください。

alicloud_region: cn-beijing
alicloud_zone: cn-beijing-a

以下に各リージョンのイメージIDを示します（Linux, Nginx, MySQL, Jdk-Tomcatイメージの場合）。もちろん、地域に応じてイメージIDを変更する必要があります。

Jenkinsジョブを使用してAlibaba VMを作成してデプロイする

Jenkinsジョブを使用してAlibaba VMを作成してデプロイするには、以下の手順に従います。

Jenkinsダッシュボードから、New Itemを選択します。

名前を入力し、「Freestyle project」を選択し、「OK」をクリックします。

(オプション) 一般の下に、参考のために簡単な説明を記載してください。

上部のソースコード管理（SCM）タブを選択するか、スクロールダウンして以下の情報を入力します。

SCM: - Git
リポジトリのURL：- GitHubのリンクにパラメータを変更したもの
例：https://github.com/nadaraj15/alibaba_ansible/
資格情報：- なし (パブリックリポジトリなので、プライベートの場合は Jenkins に資格情報を保存)
ブランチ指定子 ( 'any' の場合は空白): - */master

次に、ビルドトリガーはとりあえずスキップして、ビルド環境に移動します。新しいプロジェクトを作成する際には、いくつかの設定が用意されています。この設定ページでは、スクリプトを実行するなどの余分なアクションを実行するためのビルドステップを追加するオプションもあります。というよりも、シェルスクリプトを実行して、GitHubからAnsible Playbookファイルをダウンロードします。以下のコマンドを使用します。

sudo apt-get update  (Optional)
sudo apt-get install -y libssl-dev libffi-dev python-dev python-pip (Optional)
sudo pip install ansible[azure]==2.7.0rc2 (Optional)
sudo apt-get install -y maven (Optional)
cd /usr/bin
sudo wget https://raw.githubusercontent.com/nadaraj15/alibaba_ansible/master/AliVM.yml

ビルドステップを追加して ansible playbook を起動したいと思います。このステップは ansible playbook を実行します。以下の情報を入力します。

Playbook path: - AliVM.yml (プレイブック名)
Inventory： - 「Inventoryを指定しない」を選択
Credentials:- 「なし」を選択します(デプロイメントファイルに資格情報を埋め込んでいるので、環境変数として資格情報を渡すことができます)

デプロイ後のワークスペースをクリーンアップし、以下のコマンドでシェルスクリプトの実行ステップを追加します。

注意: jenkins_homeがあなたの場所である場合、デフォルトのパスは/var/jenkins_homeに設定されています。しかし、カスタムの場所がある場合は、その代わりにその場所を使用することができます。

sudo rm -rf /var/jenkins_home/workspaces/<workspace_name>

必要に応じてポストビルトアクションを追加します。最後に、すべてのステップが設定されたら、保存をクリックします。

Jenkinsプロジェクトダッシュボードに移動し、「Build now」をクリックして手動でビルドをトリガーします。

コンソール出力に移動して、トリガーされたビルドステータスを確認します。すべてのリソースが正常にプロビジョニングされると、出力に成功ステータスが表示されます。

Alibaba Consoleに移動して、プロビジョニングされたAlibaba ECSと構成を確認します。

これで、Tomcat、Java、MySQLがインストールされたインスタンスをデプロイしました。ブラウザに対応するパブリックIPアドレスを入力すると、VMのパブリックIPの80番ポートを通してウェブサーバが公開されているので、Apache Tomcatのページが動作しているのが確認できます。

参考文献

1、https://www.alibabacloud.com/blog/ci%2Fcd-with-jenkins---part-1%3A-install-jenkins-on-ubuntu_593717
2、https://www.alibabacloud.com/blog/continuous-integration-with-jenkins-on-alibaba-cloud_594512
3、https://www.alibabacloud.com/blog/594449
4、https://github.com/alibaba/ansible-provider
5、https://mohitgoyal.co/2017/02/14/add-linux-slave-node-in-the-jenkins/
6、https://marketplace.alibabacloud.com/products/56728001/Tomcat_Nginx_My_SQL_Stack_Package_on_Ubuntu-cmjj011399.html?innerSource=search#product-details

アリババクラウドは日本に２つのデータセンターを有し、世界で60を超えるアベラビリティーゾーンを有するアジア太平洋地域No.1(2019ガートナー)のクラウドインフラ事業者です。
アリババクラウドの詳細は、こちらからご覧ください。
アリババクラウドジャパン公式ページ

AnsibleとJenkinsを使用してTomcat、Java、MySQLからなるイメージをデプロイ