Jenkins

Projektdateien anlegenCopy Anchor Link

Legen Sie zuerst den Bucket an. Das Plugin prüft den Bucket, legt ihn aber nicht an:

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

Erstellen Sie ein Dockerfile, das das Plugin in das Jenkins-LTS-Image installiert:

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

Das Plugin artifact-manager-s3 bringt die AWS-Zugangsdatenunterstützung mit, die es benötigt. Wenn Sie aws-credentials ausdrücklich angeben, bleibt der Typ AWS Credential verfügbar.

Bauen Sie das Image und starten Sie Jenkins im selben Docker-Netzwerk wie RustFS:

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

Schließen Sie den Einrichtungsassistenten ab und legen Sie anschließend AWS-Zugangsdaten an: Manage Jenkins → Credentials → global → Add Credentials (Jenkins verwalten, Zugangsdaten, global, Zugangsdaten hinzufügen). Wählen Sie die Art AWS Credential, die ID rustfs-creds und tragen Sie Ihren RustFS-Zugriffsschlüssel sowie den geheimen Zugriffsschlüssel ein.

Artifact Manager konfigurierenCopy Anchor Link

Öffnen Sie Manage Jenkins → AWS Configuration (aus dem Plugin aws-global-configuration) und setzen Sie:

• Region name: us-east-1
• Credentials: rustfs-creds

Öffnen Sie Manage Jenkins → System und suchen Sie den Abschnitt Artifact Management for Builds (Artefaktverwaltung für Builds). Wählen Sie Cloud Provider Amazon S3 und füllen Sie die S3-Konfiguration aus:

• S3 Bucket Name: jenkins-artifacts
• S3 Bucket Region: us-east-1
• Base Prefix: artifacts/
• Custom Endpoint: <your-rustfs-endpoint>:9000 (zum Beispiel rustfs:9000 im Compose-Netzwerk)
• Custom Signing Region: us-east-1
• Use Path Style URL: aktiviert
• Use Insecure HTTP: aktiviert
• Disable Session Token: aktiviert

Für einen Nicht-AWS-Endpunkt ohne TLS sind pfadbasierte Adressierung (Path-Style) und unverschlüsseltes HTTP erforderlich. Wenn Sie das Session-Token deaktivieren, ruft das Plugin kein AWS STS auf. Ein statisches Zugriffsschlüsselpaar kann einen STS-Aufruf nicht beantworten. Klicken Sie auf Validate S3 Bucket configuration (S3-Bucket-Konfiguration prüfen), um die Einstellungen zu bestätigen, und speichern Sie anschließend.

Job ausführen, der ein Artefakt archiviertCopy Anchor Link

Legen Sie einen Freestyle-Job (oder eine Pipeline) an, der eine Datei erzeugt und archiviert:

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

Führen Sie den Build aus und warten Sie, bis er abgeschlossen ist. Die Artefakte werden transparent nach RustFS hochgeladen. Die Job-Konfiguration erwähnt S3 dabei nicht.

Objekte in RustFS prüfenCopy Anchor Link

Listen Sie den Bucket auf:

rc ls rustfs/jenkins-artifacts/ -r

Das Artefakt liegt unter dem Präfix, geordnet nach Job und Build-Nummer:

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

Wenn Sie das Artefakt von der Build-Seite herunterladen, wird es aus RustFS gelesen.

Bereitstellung anhalten oder zurücksetzenCopy Anchor Link

Stoppen Sie Jenkins und behalten Sie die Daten:

docker rm -f jenkins

Die Artefakte bleiben im Bucket jenkins-artifacts. Um sie zu löschen, entfernen Sie den Bucket:

rc rb rustfs/jenkins-artifacts --force