HCL DevOps Code ClearCase と Jenkins 統合 - ステップバイステップガイド (Windows)
2023/12/27 - 読み終える時間: 9 分
HCL DevOps Code ClearCase Jenkins Integration on Windows - Step-by-Step Guide の翻訳版です。
HCL DevOps Code ClearCase と Jenkins 統合 - ステップバイステップガイド (Windows)
2023年12月12日
著者: Arun R / Senior Software Engineer
はじめに
Jenkins は人気のある DevOps ビルド自動化ツールです。オープンソースの統合は何年も前から利用可能ですが、この新しい統合は HCL DevOps Code ClearCase 開発チームによって作成され、HCLSoftware によって公式にサポートされています。
この統合は、Jenkinsのフリースタイルジョブとパイプラインジョブの両方をサポートします。デフォルトを超えて、HCL DevOps Code ClearCase統合は、DevOps Code ClearCase の完了トリガーから呼び出される Webhooks と、ストリーム上の変更をポーリングする DevOps Code ClearCase プラグインを持つ Jenkins ジョブを構成することによって、ビルドを開始する機能を追加します。
注: この統合により、Jenkins ジョブはビルドの必要に応じてビューを作成したり削除したりできるようになります。現在のところ、自動ビューとWebビューを持つ UCM のみがサポートされています。
| SL No: | Topic |
| 1 | 環境 |
| 2 | HCL DevOps Code ClearCase のインストール |
| 3 | Windows 上での Jenkins のインストールと設定 |
| 4 | Windows での Jenkins のアンロック |
| 5 | Jenkins のカスタマイズ |
| 6 | Jenkins サーバの SSL/TLS 設定 |
1. 環境
- HCL DevOps Code ClearCase 3.0.1 リリース。
- Jenkins LTS 2.332.x for Windows。
- Microsoft Windows 10、11、2019 Serverおよび2022 Server。
- 詳細については、システム要件のページを参照してください。
- Jenkinsをインストールする前に、Java 8専用の64ビットJava実行環境（JRE）がインストールされている必要があります。JREをまだお持ちでない場合は、Adoptiumからhttps://adoptium.net/temurin/releases/?version=8。
Javaの環境変数のパスを設定します。システム環境変数の場合
ヒント Jenkinsのインストール時にJavaのホーム・ディレクトリを指定する必要があるため、Javaのパスを覚えておいてください。
-
JAVA_HOME変数にJDKのパスを設定します。同様に、JREについてもこのようにしてください。
-
PATH変数に、JDK用のbinフォルダを設定します。
ヒント Jenkinsのインストール中にJavaのホーム・ディレクトリを指定する必要があるため、Javaへのパスを覚えておくこと。
ステップ
2. HCL DevOps Code ClearCaseのインストール
WindowsホストにJenkinsをインストールする前に、まずHCL DevOps Code ClearCaseをインストールする必要があります。HCL DevOps Code ClearCase Remote ClientまたはHCL DevOps Code ClearCaseをインストールし、Jenkinsのビルドに自動ビューを使用する場合は、インストール中に Automatic Views コンポーネントを選択する必要があります。
3. Windows上でのJenkinsのインストールと構成
以下の手順を使用して、HCL DevOps Code ClearCase と Jenkins の統合のために Windows に Jenkins をインストールします。
- Jenkins LTS 2.332.x for Windows の jenkins.msi インストール・ファイルを https://get.jenkins.io/windows-stable/2.332.4/ からダウンロードします。どのバージョンの Jenkins LTS 2.332.x でもダウンロードできるが、このブログでは 2.332.4 を使用します。
-
ダウンロードが完了したら、jenkins.msiファイルを実行し、インストールを進めます。以下のインストール手順に関する情報をいくつか示します。
- Service Logon Credentials ダイアログ・ボックスの Run service as a local or domain user オプションに、Jenkinsを実行するユーザ・アカウントのドメイン・ユーザ名とパスワードを入力します。Test Credentials をクリックして、認証データを確認します。(Run service as Local System オプションは安全性が低いため、推奨しません)。
注意: Run service as local or domain user オプションの場合、インストールを行うユーザは、サービスとしてログオンするために必要な権限を持っている必要があります。そうでない場合、アカウントが確認できないというエラーメッセージが表示されます。この状況を解決するには、ローカルセキュリティポリシーを更新して、ユーザーをユーザー権限の割り当てに追加する必要があります。
- ポートの選択]ダイアログ・ボックスで、Jenkinsを実行するポート番号を入力し、[ポートのテスト]をクリックして、選択したポートが使用可能かどうかを確認します。
- Javaホーム・ディレクトリ（JDKまたはJRE）を選択する必要がある場合、これはJavaがインストールされている場所であることを覚えておいてください。
- インストールが完了したら、Finishをクリックしてインストール・ウィザードを終了します。
4. WindowsでJenkinsのロックの解除
WindowsにJenkinsをインストールしたら、以下の手順でロックを解除します。
-
Webブラウザで、インストール中に選択したポート番号に移動します。
-
ヒント Jenkinsでポートを変更する方法については、https://phoenixnap.com/kb/jenkins-change-port を参照してください。
-
Jenkinsのアンロック・ダイアログ・ボックスが開きます。
- ダイアログ・ボックスで提供された情報から、Windowsエクスプローラを使用してinitialAdminPasswordファイルの場所に移動し、Microsoftメモ帳などのテキストエディタでファイルを開く。
- 以下はファイルのデフォルトのパスです。
- 注意：この場所は隠しディレクトリかもしれません。その場合、Windowsで隠しファイル、隠しフォルダ、隠しドライブの表示を有効にする必要があります。
- initialAdminPassword ファイルからパスワードをコピーし、Unlock Jenkinsダイアログ・ボックスの管理者パスワード・フィールドに貼り付けて、Continue をクリックします。
5. Jenkinsのカスタマイズ
Jenkins のインストール・プロセスを完了し、Jenkins のロックを解除した後、Windows 上で HCL DevOps Code ClearCase-Jenkins 統合に使用する前に、Jenkins をカスタマイズする必要があります。
以下の手順で Jenkins をカスタマイズしてから使用してください。
-
このインストールでは、Jenkins はポート 8080 でホストされます。ウェブ・ブラウザを開き、http://hostname:8080 にアクセスします。
-
Jenkinsのカスタマイズ・ダイアログ・ボックスで、最も頻繁に使用されるプラグインをJenkinsに自動的にインストールさせるには、Install suggested plugins をクリックします。
-
インスタンス構成]ダイアログ・ボックスで、Jenkinsに使用させたいポート番号を確認し、Save and Continue をクリックします。これで初期カスタマイズは完了です。
-
Start using Jenkins をクリックして、Jenkinsダッシュボードに移動します。
-
HCLDevOpsCodeClearCase-home-dir/java/lib/HCLDevOpsCodeClearCase-jenkins.hpi と HCLDevOpsCodeClearCase-home-dir/java/lib/cmapi-jenkins.hpi から HCL DevOps Code ClearCase-jenkins.hpiとcmapi-jenkins.hpi をコピーします。
-
コピーしたファイル HCLDevOpsCodeClearCase-jenkins.hpi と cmapi-jenkins.hpi を、次のステップで説明するように、Jenkins 管理ウェブページを使用してJenkinsサーバーにインストールします。
-
Manage Jenkins > Manage Plugins > Advanced タブを選択し、以下のプラグインを追加します。
- cmapi-jenkins.hpi
- HCLDevOpsCodeClearCase-jenkins.hpi
(a) Jenkinsホームページの左側に "Manage Jenkins" オプションがあるので、それを選択します。
(b) System Configuration の下にスクロールダウンすると、"Manage Plugins" があります。
(c) "Plugin Manager" の下にある "Advanced" オプションを選択してください。
(d) スクロールダウンして、"Deploy Plugin" オプションを選択します。次に、"Choose File" オプションを選択して、2つのプラグイン・ファイル、すなわち HCLDevOpsCodeClearCase-jenkins.hpi と cmapi-jenkins.hpi を選択し、"Deploy" をクリックします。
(e) 2つのプラグイン・ファイルがデプロイされると、以下の結果が表示されます。
6. JenkinsサーバーのSSL/TLS設定
- JenkinsサーバーにSSL/TLSを使用したい場合は、Jenkinsのドキュメント（https://www.jenkins.io/doc/book/installing/initial-settings/ ）を参照して、前述のコマンド・ライン・フラグの代わりに他のコマンド・ライン・フラグを使用してください。