Start Building for Free

CircleCI Server v2.17 What's New

6 months ago4 min read
On This Page

WARNING: CircleCI Server version 2.x is no longer a supported release. Please consult your account team for help in upgrading to a supported release.

This document provides a summary of features and product notes for the release of CircleCI server v2.17. For a full list of changes, including patch releases, refer to the changelog.

What’s new in release 2.17

  • Workflows now has a Slack Integration! Users can choose to receive Slack notifications when their workflows complete.
  • Administrators can now restrict which organizations are allowed into their CircleCI installation. For more details on how to enable this feature, please see the User Management Section of the 2.17 Ops Manual.
  • We changed the renamed org flow so orgs that have been renamed will no longer result in errors going forward. Existing users who had applied workarounds for this use case will now no longer require said workarounds.
  • Workflows now take up less DB space and will be easier to maintain going forward.
  • Improved the cache in front of GraphQL API resulting in overall improved performance.
  • Added backpressure to avoid overwhelming nomad with requests, this will result in increased performance from existing nomad clusters.

Fixed in release 2.17

  • Fixed some bugs related to GitHub API response handling and webhook handling.
  • Fixed issue with Scheduled Workflows when the services machine is restarted.
  • Fixed changing the RabbitMQ hostname for Scheduled Workflows when externalizing.
  • You can no longer create contexts with no names. If you are using a context with no names, it will no longer be accessible from your execution environment.
  • We have optimized our handling of large amounts of build output and test results XML, to avoid out-of-memory errors.
  • The CIRCLE_PULL_REQUEST environment variable was not being populated correctly in all cases when building across forks. This has been fixed.
  • Fixed a bug where some commits with [ci skip] in the message were still being built.
  • Fixed a bug causing Workflows to get stuck when infrastructure_failure happens after a job fails.
  • Fixed a bug causing duplicate docker networks on same nomad client (if running build using machine:true AND vm-provider=on_host).
  • Improved performance when using local storage. Previously, caching issues had been experienced when local storage was used rather than the default option of using S3 (selecting None under * Storage Driver options from the Management Console).
  • We have added more error checking and validation around GitHub’s API so the existing list commit endpoint no longer causes issues.
  • Datadog API token field was stored in plaintext, now set as a password field.
  • Fixed issue where workflows were constrained from fanning out to large number of jobs.

Updated in release 2.17

  • New machine executor AMIs based on Ubuntu 16.04 for AWS. Ubuntu 16.04 with Docker 18.09.3 has apt-daily and apt-daily-upgrade services disabled. It is highly recommended that customers try to experiment with the AMIs below before officially switching: The new images are as follows:


    They are replacing:

  • It is currently a best practice to use a Services Machine with a minimum of 32GB of RAM. Starting in v2.18 it will become required. See docs for our recommendation(s).
  • We have updated our software packages to the following versions. This is not a required update for those with externalized environments at this time, but will be when v2.18 is released.

    • Vault 1.1.2
    • Mongo 3.6.12-xenial
    • Redis 4.0.14
  • We are removing the 1.0 Single-Box options from CircleCI. We found a few critical vulnerabilities in our 1.0 build image, and we have long stopped recommending it for trials. If this is absolutely critical to your workflow please reach out to us. This does not impact people who are running 1.0 in clustered mode.

Steps to update to CircleCI Server v2.17

Steps to update to CircleCI Server v2.17 are as follows:

  1. Take a snapshot of your installation so you can roll back later if necessary (optional but recommended)
  2. Check you are running Docker v17.12.1 and update if necessary
  3. Update Replicated to v2.34.1 (steps in section below)
  4. Navigate to your Management Console dashboard (e.g. <your-circleci-hostname>.com:8800) and select the v2.17 upgrade

Snapshot for rollback

To take a snapshot of your installation:

  1. Go to the Management Console (<circleci-hostname>.com:8800) and click Stop Now to stop the CircleCI Services machine from running
  2. Ensure no jobs are running on the nomad clients – check by running nomad status
  3. Navigate to the AWS EC2 management console and select your Services machine instance
  4. Select Actions > Image > Create Image – Select the No Reboot option if you want to avoid downtime at this point. This image creation step creates an AMI that can be readily launched as a new EC2 instance to restore your installation. Note: It is also possible to automate this process with the AWS API. Subsequent AMIs/snapshots are only as large as the difference (changed blocks) since the last snapshot, such that storage costs are not necessarily larger for more frequent snapshots, see Amazon’s EBS snapshot billing document for details. Once you have the snapshot you are free to make changes on the Services machine.

If you do need to roll back at any point, see our restore from backup guide.

Update Replicated


  • Your installation is Ubuntu 14.04 or 16.04 based.
  • You are running replicated version 2.10.3<= on your services machine
    • replicated –version
  • Your installation is not airgapped and you can access the internet from it
  • All steps are completed on the Services machine
  • Verify what version of replicated you need to update to by viewing the Server Changelog

Preparations for updating Replicated

Before performing a replicated version update, backup your data using the Backup instructions.

  • Stop the CircleCI application with
    replicatedctl app stop

Application shutdown takes a few minutes. Please check the administration dashboard, and wait for the status to become “Stopped” before continuing. You can also run the following command to view the app status:

    replicatedctl app status inspect

Example Output:

        "AppID": "edd9471be0bc4ea04dfca94718ddf621",
        "Sequence": 2439,
        "State": "stopped",
        "DesiredState": "stopped",
        "Error": "",
        "IsCancellable": false,
        "IsTransitioning": false,
        "LastModifiedAt": "2018-10-23T22:00:21.314987894Z"
  • For the replicated update to succeed, it’s necessary to update docker to the recommended version, 17.12.1:
    sudo apt-get install docker-ce=17.12.1~ce-0~ubuntu
  • Pin the Docker version using the following command:
    sudo apt-mark hold docker-ce

Update Replicated

Perform the Replicated update by executing the update script as follows:

    curl -sSL "" | sudo bash

Double-check your replicated and docker versions:

Example Output

    replicatedctl version    # 2.34.1
    docker -v                # 17.12.1

Restart the app with

    replicatedctl app start

The application will take a few minutes to spin up. You can check the progress in the administration dashboard or by executing;

    replicatedctl app status inspect

Example output:

        "AppID": "edd9471be0bc4ea04dfca94718ddf621",
        "Sequence": 2439,
        "State": "started",
        "DesiredState": "started",
        "Error": "",
        "IsCancellable": true,
        "IsTransitioning": true,
        "LastModifiedAt": "2018-10-23T22:04:05.00374451Z"

Help make this document better

This guide, as well as the rest of our docs, are open source and available on GitHub. We welcome your contributions.

Need support?

Our support engineers are available to help with service issues, billing, or account related questions, and can help troubleshoot build configurations. Contact our support engineers by opening a ticket.

You can also visit our support site to find support articles, community forums, and training resources.