Jenkins Integration

Useful Links

🔗 Jenkins Login

• Local development: http://localhost:8080/login

• Cloud deployment: Your Jenkins URL (e.g., https://jenkins.example.com/login)

🔗 Important URLs

• Official Jenkins Website
• Jenkins Documentation
• User Configuration:
  • Local: http://localhost:8080/user/YOUR_USERNAME/configure
  • Cloud: https://your-jenkins-url/user/YOUR_USERNAME/configure

💡 Note: Replace your-jenkins-url with your actual Jenkins instance URL.

Jenkins Credentials

Step 1: Create API Token in Jenkins

1. Log in to your Jenkins instance at your-jenkins-url/login (e.g., https://jenkins.example.com/login).

2. Once logged in, click on your username in the top right corner.

3. Navigate to your-jenkins-url/user/your-username/configure or click Configure (gear icon).

4. Alternatively, you can:

   • Go to People → Click on your username → Configure
   • Or use the direct path: your-jenkins-url/me/configure

5. In the API Token section, click Add new Token.

6. Give your token a description (e.g., "Cokpit Integration").

7. Click Generate.

8. Copy your token immediately.

💡 Tip: Save your API token in a secure location. You won't be able to see it again!

Step 2: Add Jenkins Credentials to Cokpit

1. Navigate to Cokpit Dashboard.
2. Go to Settings → Integrations → CI/CD → Jenkins.
3. Click Add secret.

4. Fill in the required fields:
   • Enter a unique Secret Name (e.g., jenkins-secret)
   • Enter your Jenkins Endpoint URL (e.g., https://jenkins.example.com)
   • Enter your Jenkins Username
   • Paste your API Token in the password field
5. Click Submit.

Security Best Practices

• Create API tokens with minimal required permissions
• Use different tokens for different applications
• Regularly rotate API tokens
• Enable security features in Jenkins:
  • Enable authentication
  • Use HTTPS
  • Configure proper authorization
• Monitor token usage in Jenkins audit logs
• Remove unused tokens promptly