The Documentation search bar has been completely redesigned and improved to provide a full page of aggregate results, see CircleCI Docs.
The Org Switcher was updated to fix a display issue that caused users to be redirected to the wrong organization.
- The CircleCI CLI command
orb listnow has an optional flag,
--json, that provides machine-readable output. In addition, the CLI command
orb sourcehas been updated to allow you to pull any version, including dev versions, for example:
circleci orb source mynamespace/myorb@dev:foo circleci orb source firstname.lastname@example.org circleci orb source mynamespace/myorb@volatile
Cloud Performance plans have been updated to display multiple periods of usage data on the Settings page.
The CircleCI API documentation has been re-published with a completely new design and updated content, see the API Reference.
CircleCI 2.1 config keys are now available for reusing
parametersto simplify your
.circleci/config.ymlfile. See the Reusing Config document for examples and instructions. Refer to the Configuring CircleCI reference for 2.1 syntax requirements.
We have released the Xcode 10 image on CircleCI 2.0. Add the following to your
.circleci/config.ymlfile to select that version of Xcode in your jobs:
macos: xcode: "10.0.0"
Note: A known issue, for which a fix is in-progress, prevents shipping iOS apps built on the Xcode 10 image to the App Store.
- For Cloud Container macOS plans, there is an improved flow for adding containers on the Plan Overview page. This can be found under Settings > Plan Overview.
New projects are now created with 2.0 config by default and have Build Processing enabled.
CLI users are now prompted to switch to the updated CLI. All commands are backwards compatible, however some have been officially renamed. For example, the
circleci buildcommand is now an alias for the
circleci local executecommand.
For Performance Plans, total build minutes and credit usage for top projects is now displayed on the Plan Usage page. This can be found under Settings > Plan Usage
For Linux Plans, there is an improved path for adding containers on the Plan Overview page. This can be found under Settings > Plan Overview
Disabled Fixed notification through email or chat, if you have defined workflows as part of your configuration.
A Rerun workflow from beginning button is now on the Jobs page.
A 1.0 Project Badge for all projects still building on CircleCI 1.0 appears on Github.
Builds for new projects now require a CircleCI 2.0 config. 1.0 builds are no longer available for new projects. Builds for new projects without a 2.0 config will be blocked.
Updated error message when builds are not run if free minutes are depleted.
Updated information architecture with redesigned Welcome page and navigation menu for CircleCI Documentation is now available.
Auto-cancel of redundant builds now supports workflows. Customers will need to turn on the Build Processing option under Advanced Settings in their project settings. See the istructions for Enabling Auto-Cancel for Workflows Triggered by pushed to GItHub or the API for details.
A new version of the Local CLI is available. Customers using the existing Local CLI can update using the
circleci-updatecommand followed by the
circleci switchcommand. Refer to Using the CircleCI Local CLI for the update instructions.
Performance customers can now see the billing period dates on the Plan Overview page.
A new Plan Overview page that shows the details for plan selection and a new Plan Usage page that shows usages for any applicable Linux and macOS plan.
- Performance customers can now see the number of active projects with DLC enabled on the Plan Overview page.
Enable Build Processing, New API Endpoint for Triggering Projects with Workflows, and Performance Fix
- It is possible to trigger workflows with the CircleCI API using a new endpoint. See the Trigger a Build by Project section of the CircleCI API Projects Documentation.
- You must go to your Project Settings in the CircleCI app to Enable Build Processing (preview) as a prerequisite for using this endpoint.
- IMPORTANT – This endpoint does not yet support the
build_parametersoptions that the job-triggering endpoint supports.
- You may safely go back by disabling the radio button for this feature on your Advanced Settings for your project if jobs or workflows fail the new build processing.
- Resolved a known performance issue which caused a frozen page for organizations with many branches.
The Workflows page of the CircleCI app now displays the username associated with rerunning a workflow, approving a job, or cancelling a job.
Performance improvements were made for workflows pages that reduce the load time for all workflows pages.
Custom Performance Plans now appear with active users for the month on the Plan Overview page.
Alerts for users who have depleted the free Linux build minutes for the month.
- The Xcode 9.4.1 image was released on CircleCI 2.0. To select version 9.4.1 for a job, add the following to your
macos: xcode: "9.4.1"
- If you are on the Performance Plan, you can now view available credits on the Plan Overview page of your Organization Settings in the CircleCI app.
Fixed a known issue with the CircleCI workflows UI due to
.period character in the workflows name.
Fixed the interaction of the Workflows Rerun dropdown menu by restricting to open-source project users who are part of a GitHub organization.
Preview of improved builds service
CircleCI has developed an improved builds service that is ready for preview. The improved build service is the first step to a healthy roadmap of parameterized commands, config reuse across projects, improved DRY support, and better error reporting.
A preview is currently available for a few of our most adventurous organizations this week, and we plan on rolling it out to more projects in the coming weeks before it is publicly available. If you are adventurous and want to switch to the new service, be sure to read the preview docs before requesting approval.
With 2.0 you can do a lot more with the
config.yml file. However, there are those times when edits result in schema errors. The CircleCI config processor now creates and returns a specialized Job that references the specific schema error(s) in the Job list. Learn more about our recent move to the terms Workflow and Job.
The following features and additions are now available.
New Workflows Feature: If your project has a large number of tests, you can use the
circleci tests splitcommand to reduce your job run time. This feature is now supported with Workflows. For more information on how to set up test splitting, see the Splitting Test Files section of the Running Tests in Parallel documentation.
EOL Tools: The 1.0 migration center has been updated with additional content and helpful tools.
Performance Improvement: CircleCI has upgraded the mechanism that returns
gettimeofdaycalls. As a result, heavy users of
syscallwill see an aggregate improvement in performance. Most noticeably this will improve the run time of projects with heavy usage of profiling tools and Xdebug with PHP.
Added: This release adds a Plan Overview page for customers on the Performance pricing plan to enable Admins to see their selection from the Settings.
Added: Customers who are still building on CircleCI 1.0 will now get a reminder to upgrade to CircleCI 2.0 in build emails.
We have released the Xcode 9.3 image on CircleCI 2.0. Add the following to your
.circleci/config.yml file to select that version of Xcode in your jobs:
macos: xcode: "9.3.0"
We have released the Xcode 9.2 image on CircleCI 2.0. Add the following to your
.circleci/config.yml file to select that version of Xcode in your jobs:
macos: xcode: "9.2.0"
The release of CircleCI 2.0 for macOS enables your iOS projects to benefit from the significant performance, stability, and reliability improvements in the CircleCI 2.0 platform, including the following new features:
Workflows: Orchestrate jobs and steps with great flexibility using a simple set of new keys in your configuration. Increase the development speed through faster feedback, shorter reruns, and more efficient use of resources.
Advanced caching: Speed up builds by caching files from run to run using keys that are easy to control with granular caching options for cache save and restore points throughout your jobs. Cache any files from run to run using keys you can control.
Get started with the complete set of documentation for the macOS platform:
The button on the Jobs page has changed for jobs that run as part of a workflow. The rebuild options that are not compatible with Workflows have been removed from the button on the Jobs page. Jobs that ran as part of a workflow will only include the Rerun Job with SSH button on the Jobs page.
To rerun a job that ran as part of a workflow, you must navigate to the Workflows page of the CircleCI application and either rerun your entire Workflow or rerun your Workflow from failed jobs.
This feature enables Workflows to run on a configurable schedule. Refer to the Scheduling a Workflow section of the Orchestrating Workflows document for instructions and examples. Reference information for syntax is available in the
triggers section of the Writing Jobs With Steps document and answers to common questions are documented in the Workflows section of the Migration FAQ.
This feature adds the used minutes to your Org Settings > Plan Settings page. This feature displays used minutes against Linux machines. It expands on our current functionality which shows minutes used against OS X machines and is located on the same page: Org Settings > Plan Settings.
Data appears for Orgs with a billing date after Aug 31, 2017. So, a new org will immediately see minutes used, and existing orgs will see the minutes used appear within the coming 30 days, depending on the billing date for your plan.
Today we updated our Xcode 9.0 beta 3 image to Xcode 9.0 beta 5 (build version
9M202q) with the latest simulators.
You can use this image by specifying Xcode 9.0 in your circle.yml:
machine: xcode: version: "9.0"
This image tag will be automatically upgraded when new betas are released by Apple, until the final release of Xcode 9.
This feature enables filtering on Git tags for jobs in workflows using CircleCI 2.0. CircleCI will not run a job for a Git tag unless a
tags filter is specified. Refer to the instructions and examples in the Workflow Tags section of Writing Jobs With Steps and in the Git Tag Job Execution section of Orchestrating Workflows.
CircleCI 2.0 is a completely updated CI/CD platform that starts every run with a clean image which is automatically provisioned just-in-time for Linux and Android jobs on the hosted CircleCI application.
Configuration moves into the code in 2.0, so every developer can configure jobs directly in their working branch, teams can try new things without the risk of slowing anyone else down, and business leaders have the ability to operate large global teams with minimal overhead. CircleCI 2.0 prevents you from writing clean-up scripts because every run starts in the same state, eliminating the risk of polluting a test database or leaving files in places that cause problems for the next run.
The CircleCI 2.0 platform includes significant performance, stability, and reliability improvements along with the following new features:
First-class Docker Support: Choose any image to run your job steps, customizable on a per-job basis on a particular Git branch. Speed up your run times with advanced layer caching. Build docker images with full docker CLI support and full support for docker compose. Support for all programming languages and custom environments that offer more predictable output. See Specifying Container Images for instructions.
Workflows: Orchestrate jobs and steps with great flexibility using a simple set of new keys in your configuration. Share temporary files between jobs with workspaces for fan-in, fan-out, parallel, and sequential runs. Hold a workflow for a manual approval and restart a workflow from a failed job. See Orchestrating Workflows for details.
Resource Allocation: Configure your CPU and RAM needs on a per-job basis at the branch level, see the resource_class documentation for instructions. Paid accounts may request this feature from their Customer Success Manager, non-paid users may request to get started by sending email to email@example.com.
Insights: Access interactive charts and analyses in seconds. Visualize trends in your build history to identify and pinpoint bottlenecks. Understand all of your builds at a glance. View the builds that fail most, so you can fix the slowest tests to improve efficiency. See the Collecting Test Metadata documentation for information.
Debugging with SSH and CLI: Perform local job runs, configuration validation and SSH in to builds for access to log files and debugging running processes. See Using the CLI documentation to learn about running local jobs and refer to Debugging Jobs over SSH for SSH instructions.
Parallelism: Automatic provisioning of containers as they are freed without waiting for other jobs to finish. See the Parallel Job Execution documentation for examples.
Advanced Caching: Speed up builds by caching files from run to run using keys that are easy to control with granular caching options for cache save and restore points throughout your jobs. Cache any files from run to run using keys you can control, see the Caching Dependencies documentation for strategies and steps.
New Documentation: New and restructured documentation including an Overview, Hello World, Sample 2.0 config.yml File, simplified instructions for Migrating from 1.0 to 2.0, plus examples for Configuring Databases and Creating Custom Docker Images. Refer to the Migration FAQ for common questions and known limitations.
A fix to the pricing plan has been implemented which limits Linux plan capacity to the published maximum. As a result of this change, you may see builds queuing until the requisite containers are available.
Today we updated our Xcode 9.0 beta image to Xcode 9.0 beta 2 with the latest 10.2 simulators. To start using it, add the following to your
xcode: version: "9.0"
This image tag will be upgraded automatically when new betas are released by Apple, until the final release of Xcode 9.
For mobile, we have just released a build image that allows you to use the latest stable version of Xcode, 8.3.3. To start using it, add the following to your
xcode: version: "8.3.3"
The Workflows feature is available on CircleCI 2.0. It is designed with a flexible algorithm to support very complex job scheduling and orchestration using a simple set of new configuration keys. See the Steps to Configure Workflows section of the Migrating from 1.0 to 2.0 document for instructions. Refer to the Orchestrating Workflows document for examples and conceptual information.
This update makes Xcode 9 Beta available for all macOS builds. Specify version 9.0 in your
circle.yml file to override the default.
This feature enables users to log in to CircleCI with a Google account and provides new users with the opportunity to experience the application and selected demo projects without providing access to their code repository.
Now you can filter your build emails by project without doing
subject matching. This feature adds the standard
organisation.project.notifications.circleci.com to make it easy
to filter build emails into per-repo or per-org folders.
This feature enables you to import project environment variables from projects in the same organization to save time and typing. On the Settings screen for your project, click the Import Variable(s) button on the Environment Variables page and select from the list.
This feature enables you to join CircleCI without providing access to your private GitHub repos. To limit access, select Public Repos Only from the Start with Github menu on the signup page.
The logs produced by the Fastlane tools are now being stored as build artifacts so that you can easily access them later.
It is now possible to control whether to run builds for pull requests coming from forks and whether to pass the secrets from the main project to the fork on such builds, via two separate settings. Check out the Advanced Settings tab for your project for more details.
A few weeks ago we started downloading CocoaPods specs from S3 instead of Git in projects that use our iOS inference. It is now also possible to download the specs from S3 in projects with manual configuration.
Please check out this
for an example of downloading specs from S3 via a
It is now possible to upload provisioning profiles under the ‘Permissions’ section of your OS X project settings. Once uploaded, we will automatically import the profiles during your OS X builds. Profiles are encrypted at rest on the CircleCI side.
This update removes the need to keep the provisioning profiles checked into your repository and simplifies the setup of code signing for new OS X projects.
CircleCI offers the ability to link directly to build output steps. We’ve now extended this feature into build email notifications. You should now see a clickable ‘Failing Command’ on (failed) build notification emails which will open the build page to the failed command in your build output.
We have added a confirmation message to prevent users from accidentally stopping the builds on CircleCI.
We have added functionality to click through the ‘Build Timing’ graph to access different sections of the build.
Users can show share link to a particular step within their build output; Eg. https://circleci.com/gh/spotify/helios/5091#tests/containers/0/actions/4
Click here to view further updates, listed on the legacy changelog.