Add deprecation warnings for .spec.runtime

docs/build.md

@@ -14,7 +14,7 @@ SPDX-License-Identifier: Apache-2.0
  - [Defining the Strategy](#defining-the-strategy)
  - [Defining the Builder or Dockerfile](#defining-the-builder-or-dockerfile)
  - [Defining the Output](#defining-the-output)
- - [Runtime-Image](#Runtime-Image)
+ - [Runtime-Image](#Runtime-Image) (⚠️ Deprecated)
 - [BuildRun deletion](#BuildRun-deletion)
 
 ## Overview
@@ -76,7 +76,7 @@ The `Build` definition supports the following fields:
  - `spec.parameters` - Refers to a list of `name-value` that could be used to loosely type parameters in the `BuildStrategy`.
  - `spec.dockerfile` - Path to a Dockerfile to be used for building an image. (_Use this path for strategies that require a Dockerfile_)
  - `spec.sources` - [Sources](#Sources) describes a slice of artifacts that will be imported into project context, before the actual build process starts.
- - `spec.runtime` - Runtime-Image settings, to be used for a multi-stage build.
+ - `spec.runtime` - Runtime-Image settings, to be used for a multi-stage build. ⚠️ Deprecated
  - `spec.timeout` - Defines a custom timeout. The value needs to be parsable by [ParseDuration](https://golang.org/pkg/time/#ParseDuration), for example `5m`. The default is ten minutes. The value can be overwritten in the `BuildRun`.
  - `metadata.annotations[build.shipwright.io/build-run-deletion]` - Defines if delete all related BuildRuns when deleting the Build. The default is `false`.
 
@@ -282,6 +282,9 @@ At this initial stage, authentication is not supported therefore you can only do
 
 ### Runtime-Image
 
+**⚠️ Deprecated:** This feature is deprecated and will be removed in a future release.
+See https:/shipwright-io/community/blob/main/ships/deprecate-runtime.md for more information.
+
 Runtime-image is a new image composed with build-strategy outcome. On which you can compose a multi-stage image build, copying parts out the original image into a new one. This feature allows replacing the base-image of any container-image, creating leaner images, and other use-cases.
 
 The following examples illustrates how to the `runtime`:

pkg/apis/build/v1alpha1/build_types.go

@@ -98,6 +98,11 @@ type BuildSpec struct {
 
  // Runtime represents the runtime-image.
  //
+ // Deprecated: This feature is deprecated and will be removed in a
+ // future release. See
+ // https:/shipwright-io/community/blob/main/ships/deprecate-runtime.md
+ // for more information.
+ //
  // +optional
  Runtime *Runtime `json:"runtime,omitempty"`