Migrating from Ubuntu 16.04 to Ubuntu 20.04
Switching to a supported image
Swapping out the deprecated image for a supported one in the CircleCI config is straightforward. Additional work to get your pipelines to run with the newer image will depend on if the changes below apply to your project. Here’s an example config using an Ubuntu 16.04 image vs one using a 20.04 image:
version: 2.1 jobs: my-job: machine: image: ubuntu-1604:202007-01 steps: run: echo "do something"
version: 2.1 jobs: my-job: machine: image: ubuntu-2004:202201-02 steps: run: echo "do something"
Supported images (and tags) can be found in the Developer Hub.
Note: This guide will be updated over time to include additional information and tips as CircleCI and customers share their experiences with this migration.
There are many changes between Ubuntu 16.04 and 20.04 that you should be aware of before migrating. Many are changes that Canonical has made (the company behind Ubuntu), but also changes that CircleCI has made to the software that we pre-install. Let’s go through each of these changes separately.
Changes to Ubuntu
- kernel - The Linux kernel was bumped from v4.4 to v5.11.
- Python - Python v2 is no longer installed by default from Ubuntu. CircleCI still installs it, and versions can be managed via Pyenv.
- OpenSSH - OpenSSH was updated to v8.2. This is a new version that should not be affected by GitHub’s deprecation.
- Ubuntu now refuses to use RSA keys smaller than 1024 bits.
- GNU Toolchain
- glibc updated to v2.31
- binutils updated to v2.26
- GCC updated to v9,3
- Apt updated to v1.2
- Nginx updated to v1.18
- nginx-core no longer ships with the legacy geoip module enabled by default.
- Apache has been built with TLSv1.3 support.
- Apache was updated to version 2.4.29. Additionally, HTTP/2 support is now enabled.
- LXD updated to v3.0
- PHP updated to v7.4
- Perl 5.30
- MySQL updated to v5.7
- Snap & Snapcraft - Support for running and build snap packages.
- Java - OpenJDK v11 is now the default; however, CircleCI pre-installs more versions.
- OpenSSL upgraded from v1.1.0 to v1.1.1 enabling TLS v1.3
- netplan supports IPv6 privacy extensions.
- netplan can bring up devices without an IP for anonymous bridges.
- default DNS resolver is systemd-resolved.
- Bind 9.16
- SystemD takes over from SysV.
- gpg binary is provided by gnupg2.
- Chrony v3.5 replaces ntpd.
- Wireguard VPN support
- rustc 1.41
- HAProxy 2.0
- PostgreSQL 12
CircleCI Software Changes
|Software||Ubuntu 16.04||Ubuntu 20.04 (January 2022 Q1)|
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.
- Suggest an edit to this page (please read the contributing guide first).
- To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
- CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.
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.
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.