Ubuntu Focal

2 minute read

Ubuntu 20.04 LTS (Focal Fossa) On CloudBees CodeShip Basic

Ubuntu Focal build containers are now available for CloudBees CodeShip Basic. In general, the overall environment is setup and configured the same way you are familiar with. Most existing build commands should continue to work the same. The underlying OS version is Ubuntu 20.04 LTS (Focal Fossa).

Rollout Plan

On April 10, 2023 projects will automatically start running on Focal. This will be a progressive rollout over several weeks. If you would like your projects switched to Focal sooner, please let us know.

All projects need to be migrated to Focal by May 19, 2023. If you are unable to migrate by May 19th, your projects will be changed over for you which may result in failing builds.

Ubuntu Bionic reaches EOL at the end of May 2023.

If the build is running on Focal, step 6 of the build will say Preparing Ubuntu Focal Build Container.

Within that step, the logs also indicate the exact OS version:

Ubuntu 20.04.6 LTS

Key Changes

Common Issues

Many underlying package and dependency versions changed in Focal so it is possible you will encounter issues depending on your build configuration.

If you get unexpected errors the first step is to clear your project’s dependency cache. You can also add the cs clear-cache command to the start of the build to ensure the cache is not used while you are configuring the new environment.

If the build issues persist, then look at your build in a debug session which allows you to look closer and experiment with other build commands. If you did any special customizations to make your projects run in the Bionic environment, those customizations may need to either be updated for Focal, or in some cases you may no longer need them.

Keep in mind that you have sudo permissions in the build environment so you are free to use tools like apt-get to further customize the environment.

Finally, if you are using any CodeShip scripts they should work on Focal, but if you encounter any problems let us know. Also consider that with newer versions of many packages in Focal, you may not need a particular script any longer.

Opting Out

If you have a project that is failing on Focal and there is not a clear solution, you can opt that project out and stay on Bionic for now. Under Project Settings > General is a button to switch back to the old environment. All projects need to be migrated to Focal by May 19th.


If the above steps do not help to get your projects running, reach out to us. We will help you work through any migration challenges.