Jenkins

プロジェクトファイルを作成するCopy Anchor Link

先にバケットを作成します。プラグインはバケットを検証しますが、作成はしません。

rc alias set rustfs http://<your-rustfs-endpoint>:9000 <your-access-key> <your-secret-key>
rc mb rustfs/jenkins-artifacts

Jenkins LTS イメージにプラグインをインストールする Dockerfile を作成します。

FROM jenkins/jenkins:lts-jdk17
USER root
RUN jenkins-plugin-cli --plugins artifact-manager-s3 aws-credentials
USER jenkins

artifact-manager-s3 プラグインは必要な AWS 認証情報サポートを取り込みます。aws-credentials を明示すると、その認証情報タイプを利用できます。

RustFS と同じ Docker ネットワーク上で Jenkins をビルドして起動します。

docker build -t jenkins-rustfs .
docker run -d --name jenkins --network oo-rustfs_default \
  -p 8080:8080 -v jenkins-home:/var/jenkins_home jenkins-rustfs

セットアップウィザードを完了し、AWS 認証情報を作成します。Manage Jenkins（Jenkins の管理）→ Credentials（認証情報）→ global → Add Credentials（認証情報の追加）を開き、種類は AWS Credential、ID は rustfs-creds とし、RustFS のアクセスキーとシークレットキーを入力します。

アーティファクトマネージャーを設定するCopy Anchor Link

aws-global-configuration プラグインの Manage Jenkins → AWS Configuration（AWS 設定）を開き、次を設定します。

• Region name（リージョン名）: us-east-1
• Credentials: rustfs-creds

Manage Jenkins → System（システム設定）を開き、Artifact Management for Builds（ビルドのアーティファクト管理）を探します。Cloud Provider Amazon S3 を選び、S3 設定に次を入力します。

• S3 Bucket Name（S3 バケット名）: jenkins-artifacts
• S3 Bucket Region（S3 バケットのリージョン）: us-east-1
• Base Prefix（ベースプレフィックス）: artifacts/
• Custom Endpoint（カスタムエンドポイント）: <your-rustfs-endpoint>:9000（Compose ネットワーク内の例は rustfs:9000）
• Custom Signing Region（カスタム署名リージョン）: us-east-1
• Use Path Style URL（パススタイル URL を使用）: 有効
• Use Insecure HTTP（非セキュア HTTP を使用）: 有効
• Disable Session Token（セッショントークンを無効化）: 有効

TLS のない非 AWS エンドポイントでは、パススタイルアクセスと平文 HTTP が必要です。セッショントークンを無効にすると、プラグインは AWS STS を呼ばなくなります。単なるアクセスキーの組では STS に応答できません。Validate S3 Bucket configuration（S3 バケット設定の検証）をクリックして設定を確認し、保存します。

アーティファクトをアーカイブするジョブを実行するCopy Anchor Link

ファイルを生成してアーカイブするフリースタイルジョブ（またはパイプライン）を作成します。

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'echo "jenkins artifact stored on rustfs" > report.txt'
            }
        }
    }
    post {
        always {
            archiveArtifacts 'report.txt'
        }
    }
}

ビルドを実行し、完了を待ちます。アーティファクトのアップロードは透過的に RustFS へ送られます。ジョブ設定に S3 は一切出てきません。

RustFS 内のオブジェクトを確認するCopy Anchor Link

バケットを一覧します。

rc ls rustfs/jenkins-artifacts/ -r

アーティファクトはプレフィックス配下に、ジョブとビルド番号で整理されて保存されます。

artifacts/s3-artifacts-demo/3/artifacts/report.txt

ビルドページからアーティファクトをダウンロードすると、RustFS から読み戻されます。

デプロイを停止またはリセットするCopy Anchor Link

データを残したまま Jenkins を停止します。

docker rm -f jenkins

アーティファクトは jenkins-artifacts バケットに残ります。削除するにはバケットを削除します。

rc rb rustfs/jenkins-artifacts --force