Environment proxy server configuration

In your environment, proxy servers might exist between an intranet and internet. Because proxy servers can inhibit certain types of internet access, you may need to set proxy settings for each impacted machine in your installation. CloudBees CD servers or web servers can be deployed behind a proxy server.

It is not a common practice to place repository servers or agent systems behind a proxy server since these systems communicate with CloudBees CD through an intranet connection.

Configuring proxy settings for servers

  • Web server

    ecconfigure --webProxyUrl \https://<IP_ADDRESS:PORT> \
            --webNoProxyHosts <HOST1,HOST2,HOST3>
  • CloudBees CD server

    HTTP:

    ecconfigure --serverProxyHost <IP_ADDRESS_PROXY> \
            --serverProxyPort <PORT> \
            --serverNoProxyHosts "<HOST1,HOST2>"

    Where:

    <IP_ADDRESS_PROXY> is the IP address of the proxy server,

    <PORT> is the server port for the proxy server, and

    <HOST1,HOST2> is one or more comma separated host names for the servers in the configuration.

    HTTPS:

    • In wrapper.conf, set the following:

      Linux: /opt/electriccloud/electriccommander/conf/agent/wrapper.conf

      Windows: C:\ProgramData\Electric Cloud\ElectricCommander\conf\agent\wrapper.conf

      wrapper.java.additional.700=-Djava.net.useSystemProxies=true
      wrapper.java.additional.710=-Dhttps.proxyHost=35.237.115.111
      wrapper.java.additional.711=-Dhttps.proxyPort=34128
    • Import the HTTPS proxy certificate into the CloudBees CD server Java trust store:

      (Linux) cd /opt/electriccloud/electriccommander/jre/lib/security
      (Windows) cd C:\ProgramData\Electric Cloud\ElectricCommander\jre\lib\security
      
      keytool -importcert -file /tmp/CA_crt.pem -keystore cacerts -alias myArtifactory
Restart all the servers where you have applied a proxy setting. Proxy settings do not take effect until the servers are restarted.

Testing server proxy settings

Use the following task to verify your proxy server settings.

  • From the Plugin Manager web page, verify the configuration:

    • Web server: Verify the catalog can be viewed and no errors are reported when accessing the catalog URL.

    • CloudBees CD server: Verify you can install a plugin from the catalog.

Configuring proxy agents

Use ecconfigure to set proxy settings for any agent system that is deployed behind a proxy server. A proxy server is not usually placed between agents and a CloudBees CD server.

When you use a proxy agent, the proxy target must run an SSH v2 server.

Run the following command to set agent proxy settings:

ecconfigure --agentProxyHost <IP_ADDRESS_PROXY> \
            --agentProxyPort <PORT> \
            --agentNoProxyHosts "<HOST1,HOST2>"

Where:

<IP_ADDRESS_PROXY> is the IP address of the proxy server,

<PORT> is the server port for the proxy server, and

<HOST1,HOST2> is one or more comma separated host names for the servers in the configuration.