This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Releases

Shipwright releases and release notes can be found on GitHub at shipwrightio/build/releases.

Build v0.11.0

Shipwright Build v0.11.0 can be found on GitHub at shipwright-io/build v0.11.0. The CLI is available at shipwright-io/cli v0.11.0.

Upgrade Instructions

  1. Install v0.11.0 using the release YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.11.0/release.yaml

  2. (Optionally) Install the sample build strategies using the YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.11.0/sample-strategies.yaml

Deprecations

Shipwright Build v0.11.0 comes with a set of deprecations in our custom resources:

  • In Builds, spec.sources is deprecated. We will consolidate supporting a single source for a Build under spec.source. Also, HTTP sources are deprecated because we think that the focus that secure software supply chain brings, does not match with artifacts that are loaded from an HTTP endpoint.
  • In Builds, spec.dockerfile and spec.builder are deprecated. Those fields were introduced at the very beginning of this project to support relevant build strategies. But, those fields only relate to specific build strategies. Since a couple of releases, we support strategy parameters for that purpose where we will move to.
  • In BuildRuns, spec.serviceAccount.generate is deprecated. We think that the adhoc generation of service accounts does not fit very well in Kubernetes’ security principals and will therefore move away from that concept.

CLI Installation

Windows

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.11.0/cli_0.11.0_windows_x86_64.tar.gz | tar xzf - shp.exe
$ shp version
$ shp help

Mac

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.11.0/cli_0.11.0_macOS_$(uname -m).tar.gz | tar -xzf - -C /usr/local/bin shp
$ shp version
$ shp help

Linux

$ curl --silent --fail --location "https://github.com/shipwright-io/cli/releases/download/v0.11.0/cli_0.11.0_linux_$(uname -m | sed 's/aarch64/arm64/').tar.gz" | sudo tar -xzf - -C /usr/bin shp
$ shp version
$ shp help

Build v0.10.0

Shipwright Build v0.10.0 can be found on GitHub at shipwright-io/build v0.10.0. The CLI is available at shipwright-io/cli v0.10.0.

Upgrade Instructions

  1. Install v0.10.0 using the release YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.10.0/release.yaml

  2. (Optionally) Install the sample build strategies using the YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.10.0/sample-strategies.yaml

CLI Installation

Windows

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.10.0/cli_0.10.0_windows_x86_64.tar.gz | tar xzf - shp.exe
$ shp version
$ shp help

Mac

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.10.0/cli_0.10.0_macOS_$(uname -m).tar.gz | tar -xzf - -C /usr/local/bin shp
$ shp version
$ shp help

Linux

$ curl --silent --fail --location "https://github.com/shipwright-io/cli/releases/download/v0.10.0/cli_0.10.0_linux_$(uname -m | sed 's/aarch64/arm64/').tar.gz" | sudo tar -xzf - -C /usr/bin shp
$ shp version
$ shp help

Build v0.9.0

Shipwright Build v0.9.0 can be found on GitHub at shipwright-io/build v0.9.0. The CLI is available at shipwright-io/cli v0.9.0.

Upgrade Instructions

  1. Install v0.9.0 using the release YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.9.0/release.yaml

  2. (Optionally) Install the sample build strategies using the YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.9.0/sample-strategies.yaml

CLI Installation

Windows

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.9.0/cli_0.9.0_windows_x86_64.tar.gz | tar xzf - shp.exe
$ shp help

Mac

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.9.0/cli_0.9.0_macOS_x86_64.tar.gz | tar -xzf - -C /usr/local/bin shp
$ shp help

Linux

$ curl --silent --fail --location "https://github.com/shipwright-io/cli/releases/download/v0.9.0/cli_0.9.0_linux_$(uname -m | sed 's/aarch64/arm64/').tar.gz" | sudo tar -xzf - -C /usr/bin shp
$ shp help

Build v0.8.0

Shipwright Build v0.8.0 can be found on GitHub at shipwright-io/build v0.8.0. The CLI is available at shipwright-io/cli v0.8.0.

Upgrade Instructions

  1. Install v0.8.0 using the release YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.8.0/release.yaml

  2. (Optionally) Install the sample build strategies using the YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.8.0/sample-strategies.yaml

CLI Installation

Windows

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.8.0/cli_0.8.0_windows_x86_64.tar.gz | tar xzf - shp.exe
$ shp help

Mac

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.8.0/cli_0.8.0_macOS_x86_64.tar.gz | tar -xzf - -C /usr/local/bin shp
$ shp help

Linux

$ curl --silent --fail --location "https://github.com/shipwright-io/cli/releases/download/v0.8.0/cli_0.8.0_linux_$(uname -m | sed 's/aarch64/arm64/').tar.gz" | sudo tar -xzf - -C /usr/bin shp
$ shp help

Build v0.7.0

Shipwright Build v0.7.0 can be found on GitHub at shipwright-io/build v0.7.0. The CLI is available at shipwright-io/cli v0.7.0.

This release includes a deprecation for build strategies: we as of today implicitely create an emptyDir volume for all volumeMounts in your steps. In the future, you will need to explicitely define them in the build strategy, but will also be able to use other volume types.

Upgrade Instructions

  1. Install v0.7.0 using the release YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.7.0/release.yaml

  2. (Optionally) Install the sample build strategies using the YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.7.0/sample-strategies.yaml

CLI Installation

Windows

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.7.0/cli_0.7.0_windows_x86_64.tar.gz | tar xzf - shp.exe
$ shp help

Mac

$ curl --silent --fail --location https://github.com/shipwright-io/cli/releases/download/v0.7.0/cli_0.7.0_macOS_x86_64.tar.gz | tar -xzf - -C /usr/local/bin shp
$ shp help

Linux

$ curl --silent --fail --location "https://github.com/shipwright-io/cli/releases/download/v0.7.0/cli_0.7.0_linux_$(uname -m | sed 's/aarch64/arm64/').tar.gz" | sudo tar -xzf - -C /usr/bin shp
$ shp help

Build v0.6.0

Shipwright Build v0.6.0 can be found on GitHub at shipwright-io/build v0.6.0.

This release includes a breaking change to Builds: runtime images are not anymore supported. We encourage the use of multi-stage Dockerfiles instead.

Upgrade Instructions

  1. Install v0.6.0 using the release YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.6.0/release.yaml

  2. (Optionally) Install the sample build strategies using the YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.6.0/sample-strategies.yaml

Build v0.5.1

Shipwright Build v0.5.1 can be found on GitHub at shipwright-io/build v0.5.1.

This release includes a breaking change to BuildRun’s status subobject. This removal was announced in v0.4.0. Clients should use the status conditions of the BuildRun object to infer object state - see the documentation for more details.

Upgrade Instructions

  1. Ensure that your processes do not rely on the status.succeeded or status.reason fields of any BuildRun object.

  2. Install v0.5.1 using the release YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.5.1/release.yaml

Build v0.4.0

Shipwright Build v0.4.0 can be found on GitHub at shipwright-io/build v0.4.0.

This release includes several breaking changes and is incompatible with previous versions of Shipwright Build.

Upgrade Instructions

  1. Install v0.4.0 using the release YAML manifest:

    $ kubectl apply -f https://github.com/shipwright-io/build/releases/download/v0.4.0/release.yaml

  2. Download existing Build, BuildStrategy, and ClusterBuildStrategy objects from your cluster in YAML format.

  3. For each object, change the apiVersion from build.dev/v1alpha1 to shipwright.io/v1alpha1. Remove any identifiers and creation timestamps from the object’s metadata.

  4. Run kubectl apply -f against each manifest to re-create the relevant object.

Uninstalling v0.3.0

Once the desired Shipwright Build objects have been migrated to the new api group, you can remove v0.3.0 from your cluster:

  1. Delete the build-operator namespace:

    $ kubectl delete ns build-operator

  2. (optional) Delete all BuildRun, Build, BuildStrategy, and ClusterBuildStrategy objects in the build.dev api group on the cluster:

    $ kubectl delete buildrun.build.dev --all --all-namespaces
$ kubectl delete build.build.dev --all --all-namespaces
$ kubectl delete buildstrategy.build.dev --all --all-namespaces
$ kubectl delete clusterbuildstrategy.build.dev --all

  3. (optional) Delete the custom resource definitions for BuildRun, Build, BuildStrategy, and ClusterBuildStrategy in the build.dev api group:

    $ kubectl delete crd buildruns.build.dev
$ kubectl delete crd builds.build.dev
$ kubectl delete crd buildstrategies.build.dev
$ kubectl delete crd clusterbuildstrategies.build.dev

Build v0.3.0

Shipwright Build v0.3.0 can be found on GitHub at shipwright-io/build v0.3.0.

Build v0.2.0

Gobble, gobble! Shipwright Build v0.2.0 can be found on GitHub at shipwright-io/build v0.2.0.

Build v0.1.1

Shipwright Build v0.1.1 can be found on GitHub at shipwright-io/build v0.1.1.

Build v0.1.0

Shipwright Build v0.1.0 can be found on GitHub at shipwright-io/build v0.1.0.