ラボ 4: CI / CDプロセス-デプロイの自動化

Jenkinsfile の作成とGitリポジトリの初期化

Mule Mavenプラグイン構成をMule pom.xmlファイルに追加

パイプラインJenkinsジョブの作成

各gitコミット後にJenkinsジョブプロセスを自動化するポストコミットファイルを作成

VMのデスクトップに移動します。次のようなアイコンをクリックして、Git Guiアプリケーションを開きます:

Create New Repository を選択します。 Directory フィールドにプロジェクトの場所を挿入します。ラボ 1 の手順に従った場合は、次のパスを使用することができます。独自のプロジェクトを使用している場合は、プロジェクトの名前が異なる場合がありますのでご注意ください

C:/Users/workshop/AnypointStudio/studio-workspace/omni-channel-api

Create ボタンを選択します。MuleプロジェクトがGit内で初期化され、Git Gui管理コンソールが表示されます。

コミットされていない Unstaged Changes を確認し、Stage Changed ボタンを選択します。

ステージされていないファイルをステージするための追加のプロンプトが表示されたら、Yes をクリックします。

これで、変更が Unstaged Changes から Staged Changes に移動したことが確認できます。コミットメッセージを入力します:

Init Git repository

Commit ボタンをクリックしてプロジェクトをコミットします。

Anypoint Studio IDEの右側にあるパッケージ・エクスプローラーに戻ります。プロジェクトのルートディレクトリにある pom.xml ファイルを開きます。

Mule Maven Plugin へ認証情報を構成します。まず、<plugin> 要素配下にある <configuration> 要素へカーソルを移動します。次ステップにてこの要素内に CloudHub デプロイメントに関する情報を構成します。

次のxmlコードをコピーして、<configuration>エレメント内にこの新しい行を貼り付けてください。:

<cloudHubDeployment>
    <uri>https://anypoint.mulesoft.com</uri>
    <muleVersion>${mule.version}</muleVersion>
    <!-- Deploy User Parameter -->
    <username>${anypoint.username}</username>
    <password>${anypoint.password}</password>
    <!-- Environment Parameter -->
    <environment>${cloudhub.environment}</environment>
    <applicationName>${cloudhub.app}</applicationName>
    <businessGroup>${cloudhub.bg}</businessGroup>
    <workerType>${cloudhub.worker}</workerType>
    <objectStoreV2>true</objectStoreV2>
</cloudHubDeployment>

C:\Users\workshop\.m2 の下のルートユーザーフォルダに移動します。

このフォルダに settings.xml ファイルがなければ作成してください。

設定ファイル内に以下のコードを貼り付け、${anypoint.name} と ${anypoint.password} をあなたのプラットフォームのユーザーとパスワードに置き換えてください。

 ----
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
	<servers>
        <server>
          <id>anypoint-exchange-v2</id>
          <username>${anypoint.username}</username>
          <password>${anypoint.password}</password>
        </server>
	</servers>
</settings>

デスクトップからGoogle Chromeを開き、ブラウザのツールバーにあるJenkinsブックマークをクリックします。 Urlは http://localhost:8080 にしてください。

ログインします:

これでJenkinsのホームページに移動しました。 Anypoint Platform Credentialsを設定する必要があります。コードの一部にはしたくないので、Credentialsとして追加します。

下部の “Stores scoped to Jenkins” ,で “Jenkins” を選択します。次の画面で “Global credentials (unrestricted)” を選択します。最後に3つ目の画面で、左ナビゲーション欄にある “Add Credentials” を選択します。

対応するフィールドに、ご自身の環境の Anypoint Platform のユーザー名とパスワードを入力します。

“ID” テキストフィールドには、 deploy-anypoint-user と入力します。これは、6行目の Mule アプリケーションのJenkinsfile内のIDと一致しなければならないIDです。

‘OK’ を選択して、ユーザーの作成を終了します。

ダッシュボードに戻ります。

Jenkins のコンソールページにて “Create a job” リンクを選択します。

次の画面における “Enter an item name” の下にパイプライン名を入力します。（例： "omni-channel-api" ）続いて “Pipeline” を選択し、画面左下に表示されるポップアップウィンドウにて “OK” を押下します。

Jenkinsのセットアップページ内で、画面の一番下までスクロールして "Pipeline" と書かれたセクションに移動します。

“Definition” ドロップダウンで、"Pipeline script from SCM" というオプションを選択します。

"SCM" ドロップダウンで "Git" を選択します。

"Repositories" で、 "Repository URL" テキストボックスにリポジトリのパスを入力します。ディレクトリのパスには必ず file:// という接頭辞を付けてください。次のようになります。

file://C:/Users/workshop/AnypointStudio/studio-workspace/omni-channel-api

ここで画面下部の “Save” をクリックします。ビルドパイプラインのホーム画面にリダイレクトされます。

現在のページから、画面左上の “Jenkins” のナビリンクをクリックします。すると以下のような画面になります。

Jenkinsパイプラインのリンクをクリックします。

“Build now” をシングルクリックします。すぐにジョブのキックオフとステータス情報が表示されます。ビルドパイプラインはこれでMuleアプリケーションをビルドし、ユニットテストを実行し、アプリケーションをサンドボックス環境にデプロイします。これが完了すると、パイプラインはユニットテストを実行し、アプリケーションを本番環境にデプロイします。

ジョブの実行中は、ビルド番号をクリックして、左ナビ欄の "コンソール出力" をクリックすると、ログ情報を見ることができます。

Figure 1. パイプラインの進捗状況表示

また、ジョブのホームページから "Open Blue Ocean" をクリックすることで、Blue Oceanのプラグインを介して、よりすっきりとしたUIを見ることができます。

また、Anypoint StudioRuntime Manager にデプロイされたMuleアプリケーションは、https://anypoint.mulesoft.com にログインして、左のナビゲーション・ドロップダウンをクリックしてRuntime Managerに移動することでも確認できます。

Runtime Managerでは、 サンドボックス にデプロイされたアプリケーションと 本番環境 にデプロイされたアプリケーションの両方を表示できます。Runtime Managerの左ナビゲーション バーにあるサンドボックスの長方形をクリックすることで、サンドボックス ビューとプロダクション ビューを切り替えることができます。

Windows のディレクトリエクスプローラーで、Mule アプリケーションのルートディレクトリに移動します。ほとんどの場合、このパスにあるはずです:

C:/Users/workshop/AnypointStudio/studio-workspace/omni-channel-api

Mule アプリケーションのルートディレクトリ内で .git > hooks に移動します。次に、post-commitという新しいファイルを作成します。(拡張子はありません)

post-commit ファイルを右クリックして Open with を選択し、Notepadを選択して開きます。

post-commit ファイル内に以下のコードをコピーして貼り付け、保存してください:

#!/bin/sh
set PATH=%PATH%;"C:\Program Files\Git\bin"
echo %PATH%
sh.exe -x -c "curl 'http://workshop:Anypoint1357!@localhost:8080/job/{BUILD-NAME}/build?token=MULE_WORKSHOP'"

{BUILD-NAME}をプロジェクトのビルド名(例: omni-channel-api-workshop)に置き換えてください。

Google ChromeウェブブラウザからJenkins管理コンソールに戻ります。

Jenkinsジョブプロジェクトのホームページから、左ナビメニューからConfigureを選択します。

"Build Triggers" というラベルの付いたセクションまで下にスクロールします。

"Trigger builds remotely" のチェックボックスを選択します。

“Authentication Token“ のテキストエリア MULE_WORKSHOP と入力します。

Anypoint Studioのomni-channel-apiプロジェクト内で、get:\productssearch とラベルのついたフローまでスクロールダウンします。

IDE の右側にある Mule Palette から Logger コンポーネントをドラッグします。次のようなフローになります。

Logger コンポーネントの中に、ログに記録したいテキストを追加します。(例: "Hello from the Mule Workshop!)

Git Gui に切り替えます。Rescan を選択してディレクトリへの変更を見つけ、Stage Changed を選択してコミットをステージします。最後に、次のようなコミットメッセージを入力します。「Added Logger component」などのコミットメッセージを入力し、コミット ボタンをクリックして変更をコミットします。

これらの変更がコミットされると、Jenkinsジョブが自動的に起動します。Google ChromeでJenkins管理コンソールに戻ると、ビルドジョブのステータスを確認することができます。