Shared cloud configuration
Operations Center enables the sharing of cloud configuration across the Client Masters in the Operations Center cluster.
The sharing model used for shared cloud configuration is similar to the shared configuration propagation.
Unlike shared clouds or shared agents, shared cloud configuration replicates the configuration of the cloud provider to the specified Client Masters such that each Client Master has separate control of the cloud rather than leasing agents from the Operations Center server.
Supported cloud providers
-
Docker from Docker Plugin
-
Both Docker Swarm and standalone Docker hosts are supported
-
-
Amazon Elastic Compute Cloud (EC2) from Amazon EC2 Plugin
-
Microsoft Azure Cloud from Azure Slave Plugin
Other clouds may be available in future software upgrades.
The shared cloud configuration is licensed individually for each cloud type. |
Limitations
-
The plugin defining the configuration must be installed on the Client Masters within scope for using
-
The plugin versions on the Client Master(s) and the Operations Center server must be compatible in terms of configuration data model.
Violations of the requirements above may have a serious impact on cloud provisioners on Client Masters. The service administrators should ensure |
Shared configuration setup
Shared configurations should be created as Jenkins items like Client Masters, folders and templates using the New Item
action on the left hand menu in CloudBees Jenkins Operations Center. Items can be created at the root of the instance or within a folder.
-
If you create in the root of Operations Center, the cloud will be available to all Client Masters
-
If you create a shared cloud configuration item in a folder, the cloud will be available only to Client Masters within the folder or within the folders sub-folders.
Step 1. Create a new configuration item
-
Click on the "New Item" action in Jenkins root or a folder. In both cases you will be presented with the standard new item screen.
-
Provide a configuration name
-
Select the
Cloud Configuration
type that you wish to create. -
Click on
OK
button. A new configuration window will appear

Step 2. Enter the required configuration for the selected cloud
Options are similar to the standard Jenkins cloud configuration options.
if a cloud provider requires configuration of native tools or libraries then this location must be the same on all Client Masters that receive this configuration in order to operate correctly |
Step 3. Apply changes
When the shared cloud configuration is complete save or apply the configuration.
The cloud configuration will be pushed to all online Client Masters that have not opted out. of receiving shared configuration. If a Client Master is offline, the new configuration will be applied when this master connects to Operations Center.
Supported configurations
Below you can find configuration examples for the supported clouds.
As mentioned earlier, prior to configuring a shared-cloud ensure that the plugin defining the launcher
is installed on all the Client Masters within scope for using the shared cloud. === === Docker shared cloud configuration
Please refer to the Docker plugin’s Wiki page to find setup guidelines and info about supported configurations. This section describes the Operations Center specifics only.
-
Container caps are being managed individually for each Client Master, there is no global limitations of the containers number
-
Current Docker Plugin version supports TLS connection options via environment variables only. These environment variables are not being distributed to Client Masters by Docker Shared Cloud Configuration. These environment variables should be set up on Client Masters using other Jenkins features

Amazon Elastic Compute Cloud (EC2)
This Shared cloud configuration allows to share settings for Amazon EC2 cloud, which is the part of Amazon Web Services platform (AWS).
Please refer to Amazon EC2 plugin’s Wiki page to find setup guidelines and info about supported configurations. This section describes the Operations Center specifics only.
-
Instance caps are being managed individually for each Client Master, there is no global limitation for the entire Operations Center cluster.
-
If you use
Access Key ID
andSecret Access Key
to define EC2 credentials, these credentials will be shared across all CloudBees Jenkins Enterprise instances. EC2 must allow multiple logins from different places if have multiple Client Masters -
If all target CloudBees Jenkins Enterprise instances are running on EC2 instances, you can use
EC2 instance profile
to obtain credentials from the instance metadata -
Currently there is no opportunity to setup different
Regions
for CloudBees Jenkins Enterprise instances in AWS EC2 Shared Cloud Configuration. In such case use individual setups of EC2 Cloud on each master

Testing the configuration
-
If you click on the
Test Connection
button in the configuration, the test will be launched on Operations Center. Make sure that the AWS EC2 cloud is available to Operations Center. -
If the instance is configured to obtain credentials from
EC2 instance profile
, Operations Center must be running on a properly configured Amazon Machine Image -
You can also test the connection from one of Jenkins Client Masters when the configuration gets synchronized. It’s highly recommended if your AWS EC2 Shared Cloud Configuration uses
EC2 instance profile
to obtain credentials
Microsoft Azure Cloud
This Shared cloud configuration allows sharing of settings for Microsoft Azure cloud.
Please refer to Azure Slave plugin’s Wiki page to find setup guidelines and info about supported configurations.This section describes the Operations Center specifics only.
-
Instance caps are being managed individually for each Client Master. There is no global limitation for the entire Operations Center cluster.
-
The PublishSettings (Microsoft Azure Subscription Manifest) credentials will be shared across all CloudBees Jenkins Enterprise instances.
