ダウンロードとインストール方法 Jenkins on Windows

Jenkins どちらにもインストールできます Windows または Unix プラットフォームですが、このチュートリアルでは、 Windows インストールのみ。 Windows MSIインストーラーが登録します Jenkins として Windows サービスを選択し、64ビットを選択します Java ランタイムが提供されるため、自動化サーバーを迅速に構築できます。インストーラーを開く前に、お使いのマシンが次のセクションに記載されている要件を満たしていることを確認してください。

Jenkins 前提条件とシステム要件

Jenkins 静止状態では軽量ですが、ビルド履歴、ワークスペース、プラグインが蓄積されるにつれて急速に肥大化します。最初にマシンのサイズを適切に設定することで、後々の移行作業の手間を省くことができます。

ハードウェア要件：

ソフトウェア要件：

• Jenkins 走る Javaサポートされている Java 開発キット (JDK) または Java ランタイム環境（JRE）がインストールされている必要があります。 Jenkins リリースには Java 21以降; Java バージョン8、11、および17は、最新の長期サポートラインではサポート対象外となっています。
• 最新のウェブブラウザが必要です Jenkins ダッシュボード。
• 管理者権限を持つアカウント Windows 登録するには機械が必要です Jenkins サービス。

インストールを確認してください Java 続行する前に、コマンドプロンプトからバージョンを確認してください。コマンドが失敗するか、バージョンが21未満と表示される場合は、まずサポートされているJDKをインストールしてください。

:: Check the Java version available on the machine
java -version

:: Expected output resembles the following
openjdk version "21.0.5" 2024-10-15 LTS
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode)

リリースタイプ

Jenkins 2つのリリースラインが公開されており、どちらを選択するかによってアップグレードの頻度が変わります。

この手順ではLTSリリースを使用していますが、インストール手順は週次リリースでも同じです。必要な準備が整ったら、ダウンロードを開始できます。

ダウンロード方法 Jenkins?

以下の手順に従って入手してください。 Windows インストーラーを実行して、インストールを正常に完了します。

ステップ1） に行く https://www.jenkins.io/download/ そしてプラットフォームを選択します。私たちの場合は、 Windows.

ステップ2） ローカルコンピュータのダウンロード場所に移動し、ダウンロードしたパッケージを解凍してください。 Double解凍したファイルをクリックします ジェンキンス.msi ファイルにソフトウェアを指定する必要があります。 Jenkins WAR（Webアプリケーションアーカイブ）ファイルから実行することもできますが、その方法は推奨されません。 Windows インストーラーが処理するサービス登録をスキップするためです。

注意： Windows SmartScreenは、認識されていないアプリケーションの起動を阻止したと報告する場合があります。 詳しくはをタップし、その後、 とにかく走る署名済みのものを続ける Jenkins インストーラ。

ステップ3） Jenkins 設定画面でクリック 次へ.

ステップ4） 場所を選択してください Jenkins インスタンスをインストールする必要があります。現在の 64 ビットインストーラーのデフォルトの場所は はC：\ Program Files \Jenkinsこのパスをメモしておいてください。初期管理者パスワードはこのパス内に保存されています。 次へ.

ステップ5） 次に、インストーラーはサービスログオン資格情報とポート番号を要求します。専用のローカルアカウントまたはドメインアカウントを入力してクリックします。 テスト資格次にポートを設定してクリックします テストポート。 ポート 8080 デフォルトです。実行中 Jenkins 名前付きサービスアカウントの下では、LocalSystem オプションよりも安全です。LocalSystem オプションでは、 Jenkins マシンへの完全なアクセス権。

ステップ6） 確認する Java インストーラーが検出するホームディレクトリを確認し、カスタムセットアップオプションを確認して、 インストールを開始する ボタン。インストールが完了したら、クリックします。 仕上げ.

ステップ7） インストールプロセス中に、現在のインストールの終了時に再起動が必要であることを知らせる情報パネルが表示される場合があります。 OK 情報パネルが表示されたら、そのボタンを押してください。

ファイルはディスクに保存され、サービスも登録されました。次の段階では、ウェブインターフェースが利用可能になります。

ブロックを解除する方法 Jenkins?

完了後 Jenkins インストール段階では、自動生成されたパスワードを入力するまでコントローラーはロックされています。以下の手順でロックを解除する方法を説明します。 Jenkins アプリケーション：

ステップ1） インストールプロセスが完了すると、ブラウザタブが開き、初期管理者パスワードの入力を求められます。 Jenkinsウェブブラウザで以下のパスにアクセスしてください。
http://localhost:8080

上記のURLにアクセスできれば、インストールは成功し、サービスが稼働しています。

ステップ2） 初期管理者パスワードは以下に保存されます。 Jenkins インストール手順4で設定したインストールパス。デフォルトの場所の場合 はC：\ Program Files \Jenkinsというファイル 初期管理者パスワード 以下に見つかります はC：\ Program Files \Jenkins秘密カスタムパスが選択されている場合は、代わりにその場所を確認します。同じ値が次の場所にも書き込まれます。 jenkins.err.log 内のファイル Jenkins ホームディレクトリ。

ステップ3） ハイライトされたファイルを開き、その内容をコピーします。 初期管理者パスワード ファイルにソフトウェアを指定する必要があります。

ステップ4） パスワードを貼り付けてください 管理者パスワード ロック解除フィールド Jenkins ブラウザでページを開き、 続ける

コントローラーのロックが解除されると、セットアップウィザードはプラグインと最初のユーザーアカウントの設定に進みます。

カスタマイズ Jenkins

カスタマイズすることもできます Jenkins 以下の手順に従って環境を構築してください。

ステップ1） クリック 推奨プラグインをインストールする ボタンのように Jenkins 必要なプラグインを取得してインストールします。

Jenkins 新しいプラグインを作成するために必要なすべてのプラグインのダウンロードとインストールを開始します Jenkins 。

注意： オプションを選択できます インストールするプラグインを選択してください そして、必要なプラグインだけを選択します。プラグインは後から追加または削除できます。 管理 Jenkins プラグインつまり、この選択は永続的なものではありません。

ステップ2） 推奨プラグインがすべてインストールされたら、 最初の管理者ユーザーを作成する パネルが表示されます。すべてのフィールドに希望するアカウントの詳細を入力し、 保存して終了

ステップ3） Jenkins ついに、 URL インスタンスにアクセスする場所。後で混乱しないように、デフォルト値のままにしてください。別のアプリケーションが既にポート 8080 を使用している場合は、ここで別のポートを指定して、[ 保存して続行

おめでとうございます！新しい Jenkins サーバーがインストールされました。 使い始める Jenkins

その Jenkins インスタンスが起動し、最初のジョブを実行する準備が整いました。 Jenkins 初心者向けチュートリアル その仕事の作り方を説明します。

確認方法 Jenkins サービスのインストールと管理

一度読み込まれるダッシュボードは、正常なインストールの証明にはなりません。MSIインストーラーは Jenkins として Windows サービスは、再起動後も正常に動作し、必要に応じてスムーズに再起動する必要があります。セットアップウィザードが終了したら、以下のチェック項目をすぐに実行してください。

1. サービスが存在することを確認してください。 メディア掲載 勝利+ R、タイプ services.msc、そして Enter キーを押します。次のエントリを探します。 Jenkins そしてステータスが「 Running: 起動タイプは次のように表示されます オートマチック.
2. 使用中のアカウントを確認してください。 プロパティを開く Jenkins サービスとレビュー ログインする タブ。ローカルでの実験以外の用途には、LocalSystemよりも専用のサービスアカウントを使用することをお勧めします。
3. リスニングポートを確認してください。 ラン netstat -ano | findstr :8080 コマンドプロンプトから。LISTENINGエントリは、 Jenkins 港を保持する。
4. バージョンバナーをお読みください。 サインインはこちら http://localhost:8080 ダッシュボードの右下隅にあるバージョン番号を確認してください。ダウンロードしたリリースのバージョン番号と比較してください。
5. 一度再起動してください。 再起動 Windows そして、何も手動で開始せずに、もう一度ダッシュボードにアクセスしてみてください。ページが読み込まれたら、サービスは完全に自動化されています。

このサービスは、管理者権限で実行したコマンドプロンプトからも制御できます。これはグラフィカルコンソールよりも高速で、デプロイメントスクリプト内でもうまく機能します。

:: Stop, start, and query the Jenkins Windows service
net stop "Jenkins"
net start "Jenkins"
sc query "Jenkins"

:: Install Jenkins silently on a fleet of machines
msiexec.exe /i "C:\installers\jenkins.msi" /qn /norestart ^
  INSTALLDIR="D:\Jenkins" ^
  PORT=8080 ^
  /L*v "C:\logs\jenkins-install.txt"

💡ヒント: サイレントインストーラーは受け入れます INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAME, SERVICE_PASSWORD プロパティのオーバーライドとして機能します。渡されなかった値はすべてデフォルト値に戻り、サイレントモードでは、サービスアカウントが指定されていない限り、サービスは LocalSystem として実行されます。

これらのチェックのいずれかが失敗した場合、その原因は通常予測可能です。次のセクションで説明します。

コマンドと Jenkins インストールエラー Windows そしてそれを修正する方法

最も失敗した Windows インストール trace 原因の小さなセットに戻ります: サポートされていない Java ランタイムの問題、使用中のポート、またはサービスとしてログオンする権限を持たないサービスアカウントなどが考えられます。それぞれに特有の症状が現れるため、メッセージを注意深く読めば通常はすぐに解決できます。

• 無効なサービスログオン認証情報: インストーラーは、 テスト資格 ステップ。開く secpol.msc、展開する ローカルポリシー > ユーザー権利の割り当て、 開いた サービスとしてログオンするそして、アカウントを追加してください。その後、認証情報のテストを再度実行してください。
• ポート8080は既に使用されています。 その テストポート ボタンが赤くなるのは、別のアプリケーション（多くの場合、ローカルの Tomcat または開発サーバー）が既にポートを使用しているためです。8081 などの空いているポートを選択するか、競合しているプロセスを停止してください。 netstat -ano.
• サポートされていないか、不足しています Java: インストーラーは事前入力できません Java ホームディレクトリを指定しないと、サービスが起動してもすぐに停止してしまいます。64ビット版のJDK 21以降をインストールし、インストーラーにそのホームディレクトリを指定してください。
• SmartScreenはインストーラーをブロックします。 Windows 認識されないアプリケーションを報告します。選択 詳しくはをタップし、その後、 とにかく走るファイルが公式のものであることを確認後 Jenkins ダウンロードページ。
• initialAdminPasswordファイルが見つかりません: カスタムインストールディレクトリが選択されました。中を見てください。 secrets そのディレクトリのフォルダ、またはパスワードを読み取る jenkins.err.log に選出しました。 Jenkins ホームディレクトリ。

Once Jenkins 安定して動作するようになったら、次の自然なステップはソースリポジトリとビルドパイプラインに接続することです。 Jenkins GitHub統合 CI / CDパイプライン このインストール環境を中心に継続的インテグレーションがどのように構築されているかを説明してください。

よくあるご質問