Stack update and removal policy

Stacks on bitrise.io are generally updated every weekend, but what’s updated depends on the stack. There are stacks where only certain caches are updated and there are stacks which are completely re-built every week. Check out our Stacks in our system reports Github site.

Xcode stacks ⚓

We use two types of Xcode stacks; Stable stacks and Edge stacks.

• Xcode Stable stacks are built once, and are not updated at all (except with Bitrise CLI related updates, dependency manager cache updates and with critical fixes). These stacks are designed so that if a build worked on the stack, the same build should run the same way as long as the stack is available.
• Xcode “Edge” stack is re-built every week. It includes the latest release of Xcode, the same pre-installed tools as on the Stable stack, and the dependency manager cache updates. The stack uses the same scripts we use for creating new Xcode stacks.

About dependency manager cache updates ⚓

All of the macOS stacks receive a dependency manager cache update (brew, cocoapods and bitrise CLI) every week. These cache updates do not change the pre-installed tool versions, they only update the package manager caches for faster dependency installs.

For more information on what else we use for provisioning the macOS VMs, head over to the weekly cache update Ansible playbook on GitHub.

Android / Linux (Docker) stacks ⚓

The Android / Linux stacks are prepared with docker, using multiple separate docker images, built on top of each other. You can find these docker images on GitHub.

• The Android & Docker, on Ubuntu stack is a rolling release stack, rebuilt automatically from a base Ubuntu image.
• The Android & Docker, on Ubuntu - LTS Stack image is a “frozen” version of a previous rolling release image, and is not updated at all (except with Bitrise CLI related updates and with critical fixes).

Hybrid (Visual Studio for Mac) stacks ⚓

The Visual Studio for Mac stacks are built on top of the latest Stable Xcode stack, so the preinstalled building tools of the base Xcode stack are not updated and are the same as in the base Xcode stack. The Xamarin specific bits are applied on top of the base Xcode image every week when generating the Visual Studio for Mac stacks (using this Ansible playbook).

The dependency manager cache updates are applied on these stacks too. Visual Studio for Mac stacks are upgraded to the latest Visual Studio for Mac versions on every weekend.

This means that the Visual Studio for Mac stacks are hybrid stacks, built on a Stable base Xcode stack, but applying certain Visual Studio for Mac and Xamarin specific bits and updates every week.

Deprecating and removing stacks ⚓

Xcode Stacks ⚓

We keep the latest patch version of every minor Xcode version as long as that Xcode version is the latest major version.

In addition, we keep the very last minor+patch version of the previous two major Xcode versions

Deprecating and removing Xcode stacks ⚓

When the first beta of the next major Xcode version is released, we deprecate all the minor versions of the last major version, except the very last version.

When the first final (non beta) version of the new major Xcode version is released, we remove the deprecated stacks; the oldest major version as well as the minor versions of the last major version except the latest minor version.

This means that the latest patch release version of Xcode is supported for about 2.5 years, in sync with Xcode major version releases.

Hybrid Stacks ⚓

Altogether we have 4 Hybrid stacks:

• The Hybrid Visual Studio for Mac Stable and Hybrid Visual Studio for Mac Beta Stacks are updated every weekend with the current Visual Studio 4 Mac Stable and Beta releases.
• The Hybrid stack, with both Android tools and Xcode 8 is affected by a long term support and deprecation policy, so it only gets the latest Bitrise CLI and critical updates.
• The Previous Hybrid stack with Xamarin and vs4mac is kept on the previous version of Visual Studio for Mac.

So when a new version of Visual Studio for Mac (vs4mac) comes out:

• The current vs4mac Stable becomes the Previous Hybrid stack with Xamarin and vs4mac.
• The current Previous Hybrid stack with Xamarin and vs4mac gets deprecated.

This means that the Hybrid Visual Studio for Mac Stable is supported for about 1 year, in sync with the major Xcode version releases.

Android/Linux Stacks ⚓

The Android/Linux LTS stack is upgraded when we release the first non LTS stack update with a new Ubuntu LTS version.

This means that an Android/Linux LTS stack is supported for about 2 years, roughly in sync with Ubuntu LTS (long term support) releases.