【初心者】いまさらJenkinsに入門する (1)インストールと基本操作

1. はじめに

• 職場に昔からJenkinsサーバがあり、いろいろな用途に使われているようだが、これまで全くノータッチだったため仕組みが分からない。自分もその運用保守をする必要が出てきそうなため、今更ながらJenkinsに入門する。

2. やったこと

• 練習用のJenkinsサーバを構築する。
• ジョブの作成、実行など基本的な操作を確認する。

3. 手順

3.1 Jenkinsサーバのインストール・初期設定

インストール

• Amazon Linux 2023 に Jenkinsをインストールして起動する。
• こちらの記事「AmazonLinux2023にJenkinsをインストールする 」が完璧なのでほぼ記事通りに実施した。

補足

• Plugin
  • 「Select plugins to install」で「Install Suggested Plugins」を選択し、おすすめのものをまとめてインストールした。GitやGitHubのプラグイン(後で使う)が含まれる。

• TmpDir変更
  • インストール直後、管理画面にログインできるが、状態が「オフライン」になってしまい、以後の作業ができない。
  • Jenkinsのデフォルトインストールではテンポラリ領域として/tmpが指定されるが、Amazon Linux 2023をEBS 16GBでインストールしたところ、/tmpが約470MBとなっており、Jenkins側で最低容量不足と判断されてしまった。
  • リンク先の記事の通り、TmpDirを別のディレクトリに変更して無事問題解消した。

(作業前)

(作業後)

3.2 基本操作確認

参考記事

• 以下の記事を参考に基本操作を確認した。
  • 記事1: 【初心者】とにかく初歩的なJenkinsの使い方
  • 記事2: Jenkins を触ってみよう

練習した操作

1) コマンド実行して結果をコンソール出力するだけのジョブの作成、実行

• 新規ジョブ作成 -> フリースタイル・プロジェクトのビルド　で新規ジョブを作成
• Build Steps -> ビルド手順の追加 -> シェルの実行　で、実行したいコマンドを記述
  • pwd
  • echo "1st job"
• 手動でビルド実行後、「コンソール出力」から実行結果を確認
  

2) ワークスペースにファイルを出力するジョブ

• 1)のコマンドの内容をファイル出力するものに変更
  • echo "1st job" > result.txt
• ビルド実行後、ワークスペースにファイル(result.txt)が作成されていることを確認

3) ビルド・トリガによるジョブの定期実行

• 手動ではなく、定期的に自動でビルドを実行する
• 対象のジョブのビルド・トリガで「定期的に実行」をチェックして実行間隔を設定

• 毎分ジョブが自動実行されることを確認する
  

4) ビルド・トリガによるhttpリクエストでのジョブの実行

• 特定のhttpリクエストを受けたらジョブを実行する
• ユーザ -> 設定 -> APIトークン　で、APIトークンを作成
• 対象のジョブのビルド・トリガで「リモートからビルド」をチェック
  
• 手元のPC(Windows11)から、curlでhttpリクエストを送信し、ジョブが実行されることを確認

# フォーマット
curl -X POST http://[Jenkinsのユーザ]:[Jenkinsのユーザに紐づくAPIトークン]@[JenkinsサーバのURL]/job/[ジョブ名]/build

# 実行例(値はダミー)
curl -X POST http://admin:123450aab4aaaaaade2f9606196c9iiiii@10.10.10.10:8080/job/1stjob/build

4 所感

• 本当にさわりだが雰囲気が分かったので、これからはビビらずに業務用のJenkinsサーバを触って理解を進めるようにしたい。