Issue

• My Cloud configuration does not work as expected.

Required Data Cloud Agents issues

This article describes how to collect the minimum required information for cloud agent issues so that it can be efficiently troubleshooted.

Cloud Agent are those ones that are created under demand. Two cases:

Case A: Cloud Agents managed by CJP-CM/CJT/CJE-MM
Case B: CloudBees Shared Clouds managed by CJP-OC/CJE-OC

If the required data is bigger than 20 MB you will not be able to use ZenDesk to upload all the information. In this case we would like to encourage you to use our upload service in order to attach all the required information.

Environment

Case A: Cloud Agents managed by CJP-CM/CJT/CJE-MM

• CloudBees Jenkins Enterprise - Managed Master (CJE-MM)
• CloudBees Jenkins Platform - Client Master (CJP-CM)
• CloudBees Jenkins Team (CJT)
• Cloud Plugins like Amazon EC2, MS Azure, Openstack, Docker plugin, etc.

Case B: CloudBees Shared Clouds managed by CJP-OC/CJE-OC

• CloudBees Jenkins Enterprise - Operation Center (CJE-OC)
• CloudBees Jenkins Platform - Operation Center (CJP-OC)
• CloudBees Share Clouds

Required Data check list

• Timeframe when the issue was exposed
• Support bundle
• Job configuration

Case A: Cloud Agents managed by CJP-CM/CJT/CJE-MM

• Cloud configuration
• Connectivity Validation and Infrastructure description

Case B: CloudBees Shared Clouds managed by CJP-OC/CJE-OC

• Share Cloud Configuration

Description

Support bundle

A support bundle from the Jenkins instance while the issue is exposed. Please, follow the KB below in case you don’t know how to generate a support bundle.

• What is a support-bundle and how to create one

Ensure that Master Log Recorders are enabled among the other options.

Job configuration

Name and config.xml of the item which use a specific Cloud template.

Case A: Cloud Agents managed by CJP-CM/CJT/CJE-MM

Cloud configuration

<cloud> section from JENKINS_HOME/config.xml in a file ( jenkins.clouds.xml).

Connectivity Validation

Output from Test Connection in a file ( test.connection.txt) from Manage Jenkins > Configure System > Cloud section > under the Cloud you have the issues with: Test Connection.

If Test Connection does not return cloud platform vendor and version (it depends on the plugins), please specify them.

Case B: CloudBees Shared Clouds managed by CJP-OC/CJE-OC

Share Cloud Configuration

Name and config.xml of the Share Cloud item.