Merge pull request #13661 from stevekuznetsov/skuznets/build-phase-doc

Merged by openshift-bot

Author: OpenShift Bot

api/protobuf-spec/github_com_openshift_origin_pkg_build_api_v1.proto

@@ -24357,7 +24357,7 @@
     "properties": {
      "phase": {
       "type": "string",
-      "description": "phase is the point in the build lifecycle."
+      "description": "phase is the point in the build lifecycle. Possible values are \"New\", \"Pending\", \"Running\", \"Complete\", \"Failed\", \"Error\", and \"Cancelled\"."
      },
      "cancelled": {
       "type": "boolean",

api/swagger-spec/oapi-v1.json

@@ -68293,7 +68293,7 @@
       "type": "string"
      },
      "phase": {
-      "description": "phase is the point in the build lifecycle.",
+      "description": "phase is the point in the build lifecycle. Possible values are \"New\", \"Pending\", \"Running\", \"Complete\", \"Failed\", \"Error\", and \"Cancelled\".",
       "type": "string"
      },
      "reason": {

api/swagger-spec/openshift-openapi-spec.json

@@ -4,9 +4,6 @@
 
 source "$(dirname "${BASH_SOURCE}")/lib/init.sh"
 
-# ensure we have the latest compiled binaries
-"${OS_ROOT}/hack/build-go.sh"
-
 platform="$(os::build::host_platform)"
 if [[ "${platform}" != "linux/amd64" ]]; then
   os::log::warning "Generating completions on ${platform} may not be identical to running on linux/amd64 due to conditional compilation."

hack/update-generated-completions.sh

@@ -228,7 +228,8 @@ type ImageChangeCause struct {
 
 // BuildStatus contains the status of a build
 type BuildStatus struct {
-	// Phase is the point in the build lifecycle.
+	// Phase is the point in the build lifecycle. Possible values are
+	// "New", "Pending", "Running", "Complete", "Failed", "Error", and "Cancelled".
 	Phase BuildPhase
 
 	// Cancelled describes if a cancel event was triggered for the build.

pkg/build/api/types.go

@@ -191,7 +191,7 @@ func (BuildSpec) SwaggerDoc() map[string]string {
 
 var map_BuildStatus = map[string]string{
 	"":                           "BuildStatus contains the status of a build",
-	"phase":                      "phase is the point in the build lifecycle.",
+	"phase":                      "phase is the point in the build lifecycle. Possible values are \"New\", \"Pending\", \"Running\", \"Complete\", \"Failed\", \"Error\", and \"Cancelled\".",
 	"cancelled":                  "cancelled describes if a cancel event was triggered for the build.",
 	"reason":                     "reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.",
 	"message":                    "message is a human-readable message indicating details about why the build has this status.",

pkg/build/api/v1/generated.proto

@@ -170,7 +170,8 @@ type ImageChangeCause struct {
 
 // BuildStatus contains the status of a build
 type BuildStatus struct {
-	// phase is the point in the build lifecycle.
+	// phase is the point in the build lifecycle. Possible values are
+	// "New", "Pending", "Running", "Complete", "Failed", "Error", and "Cancelled".
 	Phase BuildPhase `json:"phase" protobuf:"bytes,1,opt,name=phase,casttype=BuildPhase"`
 
 	// cancelled describes if a cancel event was triggered for the build.

pkg/build/api/v1/swagger_doc.go

@@ -8569,7 +8569,7 @@ var OpenAPIDefinitions *common.OpenAPIDefinitions = &common.OpenAPIDefinitions{
 				Properties: map[string]spec.Schema{
 					"phase": {
 						SchemaProps: spec.SchemaProps{
-							Description: "phase is the point in the build lifecycle.",
+							Description: "phase is the point in the build lifecycle. Possible values are \"New\", \"Pending\", \"Running\", \"Complete\", \"Failed\", \"Error\", and \"Cancelled\".",
 							Type:        []string{"string"},
 							Format:      "",
 						},