Shared cloud configuration

On this page

Supported cloud providers
Limitations
Shared configuration setup
Supported configurations

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

Figure 1. New item screen

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

Figure 2. Docker Shared Cloud Configuration screen

Testing the configuration

If you click on the Test Connection button in the configuration, the test will be performed on CJOC. Make sure that the remote Docker host is available to CJOC
You can also test the connection from one of Jenkins Client Masters when the configuration gets synchronized

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 and Secret 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

Figure 3. AWS EC2 shared cloud configuration setup

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.

Figure 4. Microsoft Azure Shared Cloud Configuration setup

Testing the configuration

A test will be launched on Operations Center when you click on the Verify Template button in the configuration
You can also test the connection from one of Jenkins Client Masters when the configuration gets synchronized.