🤔 What Are Upstream and Downstream Jobs?

• 🔼 Upstream Job: A job that triggers another job when it completes.

• 🔽 Downstream Job: A job that is triggered by another job.

🧩 How Do They Work Together?

Imagine a pipeline with three tasks:

1. Job A (🔼 Upstream): Builds the application.

2. Job B (🔽 Downstream): Tests the build.

Job A → Job B

Simple, right? Let's set them up! 💡

🛠️ Setting Up Upstream and Downstream Jobs

1️⃣ Create the Upstream Job

1. Go to your Jenkins Dashboard.

2. Click New Item 🆕.

3. Enter a name (e.g., A 🛠️) and select Pipeline.

4. Add your configuration for the build (e.g., source code checkout, build steps).

5. Save the job ✅.

pipeline{
    agent any
    stages{
        stage('Hello'){
            steps{
                echo "Hello from A"
            }
        }
        post{
            success{
                    build job: 'B'
            }
        }
    }
}

2️⃣ Create the Downstream Job

1. Go back to your Jenkins Dashboard.

2. Click New Item 🆕 again.

3. Enter a name (e.g., B🧪) and select Pipeline.

4. Add your configuration for testing (e.g., run unit tests).

5. Save the job ✅.

pipeline{
    agent any
    stages{
        stage('Hello'){
           steps{
                echo "Hello from B"
            }
        }
    }
}

3️⃣ Link the Jobs Together

🔗 Option 1: Post-Build Action in Upstream Job

1. Open the Upstream Job (A 🛠️).

2. Go to the Post-build Actions section.

3. Choose Build other projects.

4. Enter the downstream job name (e.g., B 🧪).

5. Select the trigger condition:

   • Only if build is stable (recommended 🟢).

   • Even if the build is unstable or fails 🔴.

6. Save the configuration ✅.

Now, B 🧪 will automatically trigger after A🛠️ finishes! 🎉

🔗 Option 2: Build Trigger in Downstream Job

1. Open the Downstream Job (B 🧪).

2. Go to the Build Triggers section.

3. Check Build after other projects are built.

4. Enter the upstream job name (e.g., A 🛠️).

5. Save the configuration ✅.

🔄 This setup creates the same dependency but from the downstream job's perspective.

🔍 Visualizing Job Dependencies

Jenkins makes it easy to see how jobs are connected:

1️⃣ Links on Job Pages

• Upstream Projects: Shows jobs that trigger the current job 🔼.

• Downstream Projects: Shows jobs triggered by the current job 🔽.

2️⃣ Graphical View

1. Install the Dependency Graph Viewer plugin 📊:

   • Go to Manage Jenkins > Manage Plugins > Available.

   • Search for and install Dependency Graph Viewer.

2. View the graph under Project Relationships.

🌟 Best Practices for Upstream and Downstream Jobs

1. Separate Responsibilities:

   • Use upstream jobs for building 🛠️.

   • Use downstream jobs for testing 🧪 and deploying 🚀.

2. Use Notifications:

   • Configure email or Slack alerts 📧 to stay informed about job statuses.

3. Handle Failures Gracefully:

   • Ensure downstream jobs only trigger if upstream jobs succeed.

4. Parallel Execution:

   • Run multiple downstream jobs simultaneously to save time ⏱️.

✨ Real-World Use Cases

1. Continuous Integration (CI):

   • Upstream Job: Compile and package the app 📦.

   • Downstream Job: Run unit and integration tests 🧪.

2. Continuous Deployment (CD):

   • Upstream Job: Test the app 🧪.

   • Downstream Job: Deploy to staging and production 🚀.

🎉 Conclusion

By mastering upstream and downstream jobs, you can orchestrate complex workflows in Jenkins with ease. Whether you’re automating a CI/CD pipeline or managing dependencies, this feature ensures smooth operations.

Ready to level up your Jenkins game? Start linking your jobs today! 🔗✨