From e5968ec703080e1aed217bb37a100963eb69bd79 Mon Sep 17 00:00:00 2001 From: tejal29 Date: Fri, 19 Jun 2020 17:37:08 -0700 Subject: [PATCH 1/3] add suggestion protos and hook up with Event API --- docs/content/en/api/skaffold.swagger.json | 332 ++++++++++- docs/content/en/docs/references/api/grpc.md | 85 ++- pkg/skaffold/errors/errors.go | 35 +- pkg/skaffold/event/event.go | 51 +- proto/skaffold.pb.go | 581 ++++++++++++-------- proto/skaffold.proto | 47 +- 6 files changed, 822 insertions(+), 309 deletions(-) diff --git a/docs/content/en/api/skaffold.swagger.json b/docs/content/en/api/skaffold.swagger.json index ca5e277f1fa..27962bde4b5 100644 --- a/docs/content/en/api/skaffold.swagger.json +++ b/docs/content/en/api/skaffold.swagger.json @@ -196,6 +196,59 @@ ], "default": "OK" }, + { + "name": "event.buildEvent.actionableErr.errCode", + "description": " - OK: A default status code for events that do not have an associated phase.\nTypically seen with the DevEndEvent event on success.\n - STATUSCHECK_SUCCESS: Status Check Success\n - BUILD_SUCCESS: Build Success\n - BUILD_PUSH_ACCESS_DENIED: Build error due to push access denied\n - BUILD_PROJECT_NOT_FOUND: Build error due to GCP project not found.\n - STATUSCHECK_IMAGE_PULL_ERR: Container image pull error\n - STATUSCHECK_CONTAINER_CREATING: Container creating error\n - STATUSCHECK_RUN_CONTAINER_ERR: Container run error\n - STATUSCHECK_CONTAINER_TERMINATED: Container is already terminated\n - STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING: Deployment waiting for rollout\n - STATUSCHECK_CONTAINER_RESTARTING: Container restarting error\n - STATUSCHECK_NODE_MEMORY_PRESSURE: Node memory pressure error\n - STATUSCHECK_NODE_DISK_PRESSURE: Node disk pressure error\n - STATUSCHECK_NODE_NETWORK_UNAVAILABLE: Node network unavailable error\n - STATUSCHECK_NODE_PID_PRESSURE: Node PID pressure error\n - STATUSCHECK_NODE_UNSCHEDULABLE: Node unschedulable error\n - STATUSCHECK_NODE_UNREACHABLE: Node unreachable error\n - STATUSCHECK_NODE_NOT_READY: Node not ready error\n - STATUSCHECK_FAILED_SCHEDULING: Scheduler failure error\n - STATUSCHECK_UNHEALTHY: Readiness probe failed\n - STATUSCHECK_KUBECTL_CONNECTION_ERR: Kubectl connection error\n - STATUSCHECK_KUBECTL_PID_KILLED: Kubectl process killed error\n - UNKNOWN_ERROR: Could not determine error and phase\n - STATUSCHECK_UNKNOWN: Status Check error unknown\n - STATUSCHECK_UNKNOWN_UNSCHEDULABLE: Container is unschedulable due to unknown reasons\n - STATUSCHECK_CONTAINER_WAITING_UNKNOWN: Container is waiting due to unknown reason\n - STATUSCHECK_UNKNOWN_EVENT: Container event reason unknown\n - DEPLOY_UNKNOWN: Deploy failed due to unknown reason\n - SYNC_UNKNOWN: SYNC failed due to known reason\n - BUILD_UNKNOWN: Build failed due to unknown reason\n - DEVINIT_UNKNOWN: Dev Init failed due to unknown reason\n - CLEANUP_UNKNOWN: Cleanup failed due to unknown reason\n - SYNC_INIT_ERROR: File Sync Initialize failure\n - DEVINIT_REGISTER_BUILD_DEPS: Failed to configure watcher for build dependencies in dev loop\n - DEVINIT_REGISTER_TEST_DEPS: Failed to configure watcher for test dependencies in dev loop\n - DEVINIT_REGISTER_DEPLOY_DEPS: Failed to configure watcher for deploy dependencies in dev loop\n - DEVINIT_REGISTER_CONFIG_DEP: Failed to configure watcher for Skaffold configuration file.", + "in": "query", + "required": false, + "type": "string", + "enum": [ + "OK", + "STATUSCHECK_SUCCESS", + "BUILD_SUCCESS", + "BUILD_PUSH_ACCESS_DENIED", + "BUILD_PROJECT_NOT_FOUND", + "STATUSCHECK_IMAGE_PULL_ERR", + "STATUSCHECK_CONTAINER_CREATING", + "STATUSCHECK_RUN_CONTAINER_ERR", + "STATUSCHECK_CONTAINER_TERMINATED", + "STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING", + "STATUSCHECK_CONTAINER_RESTARTING", + "STATUSCHECK_NODE_MEMORY_PRESSURE", + "STATUSCHECK_NODE_DISK_PRESSURE", + "STATUSCHECK_NODE_NETWORK_UNAVAILABLE", + "STATUSCHECK_NODE_PID_PRESSURE", + "STATUSCHECK_NODE_UNSCHEDULABLE", + "STATUSCHECK_NODE_UNREACHABLE", + "STATUSCHECK_NODE_NOT_READY", + "STATUSCHECK_FAILED_SCHEDULING", + "STATUSCHECK_UNHEALTHY", + "STATUSCHECK_KUBECTL_CONNECTION_ERR", + "STATUSCHECK_KUBECTL_PID_KILLED", + "UNKNOWN_ERROR", + "STATUSCHECK_UNKNOWN", + "STATUSCHECK_UNKNOWN_UNSCHEDULABLE", + "STATUSCHECK_CONTAINER_WAITING_UNKNOWN", + "STATUSCHECK_UNKNOWN_EVENT", + "DEPLOY_UNKNOWN", + "SYNC_UNKNOWN", + "BUILD_UNKNOWN", + "DEVINIT_UNKNOWN", + "CLEANUP_UNKNOWN", + "SYNC_INIT_ERROR", + "DEVINIT_REGISTER_BUILD_DEPS", + "DEVINIT_REGISTER_TEST_DEPS", + "DEVINIT_REGISTER_DEPLOY_DEPS", + "DEVINIT_REGISTER_CONFIG_DEP" + ], + "default": "OK" + }, + { + "name": "event.buildEvent.actionableErr.message", + "in": "query", + "required": false, + "type": "string" + }, { "name": "event.deployEvent.status", "in": "query", @@ -255,6 +308,59 @@ ], "default": "OK" }, + { + "name": "event.deployEvent.actionableErr.errCode", + "description": " - OK: A default status code for events that do not have an associated phase.\nTypically seen with the DevEndEvent event on success.\n - STATUSCHECK_SUCCESS: Status Check Success\n - BUILD_SUCCESS: Build Success\n - BUILD_PUSH_ACCESS_DENIED: Build error due to push access denied\n - BUILD_PROJECT_NOT_FOUND: Build error due to GCP project not found.\n - STATUSCHECK_IMAGE_PULL_ERR: Container image pull error\n - STATUSCHECK_CONTAINER_CREATING: Container creating error\n - STATUSCHECK_RUN_CONTAINER_ERR: Container run error\n - STATUSCHECK_CONTAINER_TERMINATED: Container is already terminated\n - STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING: Deployment waiting for rollout\n - STATUSCHECK_CONTAINER_RESTARTING: Container restarting error\n - STATUSCHECK_NODE_MEMORY_PRESSURE: Node memory pressure error\n - STATUSCHECK_NODE_DISK_PRESSURE: Node disk pressure error\n - STATUSCHECK_NODE_NETWORK_UNAVAILABLE: Node network unavailable error\n - STATUSCHECK_NODE_PID_PRESSURE: Node PID pressure error\n - STATUSCHECK_NODE_UNSCHEDULABLE: Node unschedulable error\n - STATUSCHECK_NODE_UNREACHABLE: Node unreachable error\n - STATUSCHECK_NODE_NOT_READY: Node not ready error\n - STATUSCHECK_FAILED_SCHEDULING: Scheduler failure error\n - STATUSCHECK_UNHEALTHY: Readiness probe failed\n - STATUSCHECK_KUBECTL_CONNECTION_ERR: Kubectl connection error\n - STATUSCHECK_KUBECTL_PID_KILLED: Kubectl process killed error\n - UNKNOWN_ERROR: Could not determine error and phase\n - STATUSCHECK_UNKNOWN: Status Check error unknown\n - STATUSCHECK_UNKNOWN_UNSCHEDULABLE: Container is unschedulable due to unknown reasons\n - STATUSCHECK_CONTAINER_WAITING_UNKNOWN: Container is waiting due to unknown reason\n - STATUSCHECK_UNKNOWN_EVENT: Container event reason unknown\n - DEPLOY_UNKNOWN: Deploy failed due to unknown reason\n - SYNC_UNKNOWN: SYNC failed due to known reason\n - BUILD_UNKNOWN: Build failed due to unknown reason\n - DEVINIT_UNKNOWN: Dev Init failed due to unknown reason\n - CLEANUP_UNKNOWN: Cleanup failed due to unknown reason\n - SYNC_INIT_ERROR: File Sync Initialize failure\n - DEVINIT_REGISTER_BUILD_DEPS: Failed to configure watcher for build dependencies in dev loop\n - DEVINIT_REGISTER_TEST_DEPS: Failed to configure watcher for test dependencies in dev loop\n - DEVINIT_REGISTER_DEPLOY_DEPS: Failed to configure watcher for deploy dependencies in dev loop\n - DEVINIT_REGISTER_CONFIG_DEP: Failed to configure watcher for Skaffold configuration file.", + "in": "query", + "required": false, + "type": "string", + "enum": [ + "OK", + "STATUSCHECK_SUCCESS", + "BUILD_SUCCESS", + "BUILD_PUSH_ACCESS_DENIED", + "BUILD_PROJECT_NOT_FOUND", + "STATUSCHECK_IMAGE_PULL_ERR", + "STATUSCHECK_CONTAINER_CREATING", + "STATUSCHECK_RUN_CONTAINER_ERR", + "STATUSCHECK_CONTAINER_TERMINATED", + "STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING", + "STATUSCHECK_CONTAINER_RESTARTING", + "STATUSCHECK_NODE_MEMORY_PRESSURE", + "STATUSCHECK_NODE_DISK_PRESSURE", + "STATUSCHECK_NODE_NETWORK_UNAVAILABLE", + "STATUSCHECK_NODE_PID_PRESSURE", + "STATUSCHECK_NODE_UNSCHEDULABLE", + "STATUSCHECK_NODE_UNREACHABLE", + "STATUSCHECK_NODE_NOT_READY", + "STATUSCHECK_FAILED_SCHEDULING", + "STATUSCHECK_UNHEALTHY", + "STATUSCHECK_KUBECTL_CONNECTION_ERR", + "STATUSCHECK_KUBECTL_PID_KILLED", + "UNKNOWN_ERROR", + "STATUSCHECK_UNKNOWN", + "STATUSCHECK_UNKNOWN_UNSCHEDULABLE", + "STATUSCHECK_CONTAINER_WAITING_UNKNOWN", + "STATUSCHECK_UNKNOWN_EVENT", + "DEPLOY_UNKNOWN", + "SYNC_UNKNOWN", + "BUILD_UNKNOWN", + "DEVINIT_UNKNOWN", + "CLEANUP_UNKNOWN", + "SYNC_INIT_ERROR", + "DEVINIT_REGISTER_BUILD_DEPS", + "DEVINIT_REGISTER_TEST_DEPS", + "DEVINIT_REGISTER_DEPLOY_DEPS", + "DEVINIT_REGISTER_CONFIG_DEP" + ], + "default": "OK" + }, + { + "name": "event.deployEvent.actionableErr.message", + "in": "query", + "required": false, + "type": "string" + }, { "name": "event.portEvent.localPort", "in": "query", @@ -376,6 +482,59 @@ ], "default": "OK" }, + { + "name": "event.statusCheckEvent.actionableErr.errCode", + "description": " - OK: A default status code for events that do not have an associated phase.\nTypically seen with the DevEndEvent event on success.\n - STATUSCHECK_SUCCESS: Status Check Success\n - BUILD_SUCCESS: Build Success\n - BUILD_PUSH_ACCESS_DENIED: Build error due to push access denied\n - BUILD_PROJECT_NOT_FOUND: Build error due to GCP project not found.\n - STATUSCHECK_IMAGE_PULL_ERR: Container image pull error\n - STATUSCHECK_CONTAINER_CREATING: Container creating error\n - STATUSCHECK_RUN_CONTAINER_ERR: Container run error\n - STATUSCHECK_CONTAINER_TERMINATED: Container is already terminated\n - STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING: Deployment waiting for rollout\n - STATUSCHECK_CONTAINER_RESTARTING: Container restarting error\n - STATUSCHECK_NODE_MEMORY_PRESSURE: Node memory pressure error\n - STATUSCHECK_NODE_DISK_PRESSURE: Node disk pressure error\n - STATUSCHECK_NODE_NETWORK_UNAVAILABLE: Node network unavailable error\n - STATUSCHECK_NODE_PID_PRESSURE: Node PID pressure error\n - STATUSCHECK_NODE_UNSCHEDULABLE: Node unschedulable error\n - STATUSCHECK_NODE_UNREACHABLE: Node unreachable error\n - STATUSCHECK_NODE_NOT_READY: Node not ready error\n - STATUSCHECK_FAILED_SCHEDULING: Scheduler failure error\n - STATUSCHECK_UNHEALTHY: Readiness probe failed\n - STATUSCHECK_KUBECTL_CONNECTION_ERR: Kubectl connection error\n - STATUSCHECK_KUBECTL_PID_KILLED: Kubectl process killed error\n - UNKNOWN_ERROR: Could not determine error and phase\n - STATUSCHECK_UNKNOWN: Status Check error unknown\n - STATUSCHECK_UNKNOWN_UNSCHEDULABLE: Container is unschedulable due to unknown reasons\n - STATUSCHECK_CONTAINER_WAITING_UNKNOWN: Container is waiting due to unknown reason\n - STATUSCHECK_UNKNOWN_EVENT: Container event reason unknown\n - DEPLOY_UNKNOWN: Deploy failed due to unknown reason\n - SYNC_UNKNOWN: SYNC failed due to known reason\n - BUILD_UNKNOWN: Build failed due to unknown reason\n - DEVINIT_UNKNOWN: Dev Init failed due to unknown reason\n - CLEANUP_UNKNOWN: Cleanup failed due to unknown reason\n - SYNC_INIT_ERROR: File Sync Initialize failure\n - DEVINIT_REGISTER_BUILD_DEPS: Failed to configure watcher for build dependencies in dev loop\n - DEVINIT_REGISTER_TEST_DEPS: Failed to configure watcher for test dependencies in dev loop\n - DEVINIT_REGISTER_DEPLOY_DEPS: Failed to configure watcher for deploy dependencies in dev loop\n - DEVINIT_REGISTER_CONFIG_DEP: Failed to configure watcher for Skaffold configuration file.", + "in": "query", + "required": false, + "type": "string", + "enum": [ + "OK", + "STATUSCHECK_SUCCESS", + "BUILD_SUCCESS", + "BUILD_PUSH_ACCESS_DENIED", + "BUILD_PROJECT_NOT_FOUND", + "STATUSCHECK_IMAGE_PULL_ERR", + "STATUSCHECK_CONTAINER_CREATING", + "STATUSCHECK_RUN_CONTAINER_ERR", + "STATUSCHECK_CONTAINER_TERMINATED", + "STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING", + "STATUSCHECK_CONTAINER_RESTARTING", + "STATUSCHECK_NODE_MEMORY_PRESSURE", + "STATUSCHECK_NODE_DISK_PRESSURE", + "STATUSCHECK_NODE_NETWORK_UNAVAILABLE", + "STATUSCHECK_NODE_PID_PRESSURE", + "STATUSCHECK_NODE_UNSCHEDULABLE", + "STATUSCHECK_NODE_UNREACHABLE", + "STATUSCHECK_NODE_NOT_READY", + "STATUSCHECK_FAILED_SCHEDULING", + "STATUSCHECK_UNHEALTHY", + "STATUSCHECK_KUBECTL_CONNECTION_ERR", + "STATUSCHECK_KUBECTL_PID_KILLED", + "UNKNOWN_ERROR", + "STATUSCHECK_UNKNOWN", + "STATUSCHECK_UNKNOWN_UNSCHEDULABLE", + "STATUSCHECK_CONTAINER_WAITING_UNKNOWN", + "STATUSCHECK_UNKNOWN_EVENT", + "DEPLOY_UNKNOWN", + "SYNC_UNKNOWN", + "BUILD_UNKNOWN", + "DEVINIT_UNKNOWN", + "CLEANUP_UNKNOWN", + "SYNC_INIT_ERROR", + "DEVINIT_REGISTER_BUILD_DEPS", + "DEVINIT_REGISTER_TEST_DEPS", + "DEVINIT_REGISTER_DEPLOY_DEPS", + "DEVINIT_REGISTER_CONFIG_DEP" + ], + "default": "OK" + }, + { + "name": "event.statusCheckEvent.actionableErr.message", + "in": "query", + "required": false, + "type": "string" + }, { "name": "event.resourceStatusCheckEvent.resource", "in": "query", @@ -447,6 +606,59 @@ ], "default": "OK" }, + { + "name": "event.resourceStatusCheckEvent.actionableErr.errCode", + "description": " - OK: A default status code for events that do not have an associated phase.\nTypically seen with the DevEndEvent event on success.\n - STATUSCHECK_SUCCESS: Status Check Success\n - BUILD_SUCCESS: Build Success\n - BUILD_PUSH_ACCESS_DENIED: Build error due to push access denied\n - BUILD_PROJECT_NOT_FOUND: Build error due to GCP project not found.\n - STATUSCHECK_IMAGE_PULL_ERR: Container image pull error\n - STATUSCHECK_CONTAINER_CREATING: Container creating error\n - STATUSCHECK_RUN_CONTAINER_ERR: Container run error\n - STATUSCHECK_CONTAINER_TERMINATED: Container is already terminated\n - STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING: Deployment waiting for rollout\n - STATUSCHECK_CONTAINER_RESTARTING: Container restarting error\n - STATUSCHECK_NODE_MEMORY_PRESSURE: Node memory pressure error\n - STATUSCHECK_NODE_DISK_PRESSURE: Node disk pressure error\n - STATUSCHECK_NODE_NETWORK_UNAVAILABLE: Node network unavailable error\n - STATUSCHECK_NODE_PID_PRESSURE: Node PID pressure error\n - STATUSCHECK_NODE_UNSCHEDULABLE: Node unschedulable error\n - STATUSCHECK_NODE_UNREACHABLE: Node unreachable error\n - STATUSCHECK_NODE_NOT_READY: Node not ready error\n - STATUSCHECK_FAILED_SCHEDULING: Scheduler failure error\n - STATUSCHECK_UNHEALTHY: Readiness probe failed\n - STATUSCHECK_KUBECTL_CONNECTION_ERR: Kubectl connection error\n - STATUSCHECK_KUBECTL_PID_KILLED: Kubectl process killed error\n - UNKNOWN_ERROR: Could not determine error and phase\n - STATUSCHECK_UNKNOWN: Status Check error unknown\n - STATUSCHECK_UNKNOWN_UNSCHEDULABLE: Container is unschedulable due to unknown reasons\n - STATUSCHECK_CONTAINER_WAITING_UNKNOWN: Container is waiting due to unknown reason\n - STATUSCHECK_UNKNOWN_EVENT: Container event reason unknown\n - DEPLOY_UNKNOWN: Deploy failed due to unknown reason\n - SYNC_UNKNOWN: SYNC failed due to known reason\n - BUILD_UNKNOWN: Build failed due to unknown reason\n - DEVINIT_UNKNOWN: Dev Init failed due to unknown reason\n - CLEANUP_UNKNOWN: Cleanup failed due to unknown reason\n - SYNC_INIT_ERROR: File Sync Initialize failure\n - DEVINIT_REGISTER_BUILD_DEPS: Failed to configure watcher for build dependencies in dev loop\n - DEVINIT_REGISTER_TEST_DEPS: Failed to configure watcher for test dependencies in dev loop\n - DEVINIT_REGISTER_DEPLOY_DEPS: Failed to configure watcher for deploy dependencies in dev loop\n - DEVINIT_REGISTER_CONFIG_DEP: Failed to configure watcher for Skaffold configuration file.", + "in": "query", + "required": false, + "type": "string", + "enum": [ + "OK", + "STATUSCHECK_SUCCESS", + "BUILD_SUCCESS", + "BUILD_PUSH_ACCESS_DENIED", + "BUILD_PROJECT_NOT_FOUND", + "STATUSCHECK_IMAGE_PULL_ERR", + "STATUSCHECK_CONTAINER_CREATING", + "STATUSCHECK_RUN_CONTAINER_ERR", + "STATUSCHECK_CONTAINER_TERMINATED", + "STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING", + "STATUSCHECK_CONTAINER_RESTARTING", + "STATUSCHECK_NODE_MEMORY_PRESSURE", + "STATUSCHECK_NODE_DISK_PRESSURE", + "STATUSCHECK_NODE_NETWORK_UNAVAILABLE", + "STATUSCHECK_NODE_PID_PRESSURE", + "STATUSCHECK_NODE_UNSCHEDULABLE", + "STATUSCHECK_NODE_UNREACHABLE", + "STATUSCHECK_NODE_NOT_READY", + "STATUSCHECK_FAILED_SCHEDULING", + "STATUSCHECK_UNHEALTHY", + "STATUSCHECK_KUBECTL_CONNECTION_ERR", + "STATUSCHECK_KUBECTL_PID_KILLED", + "UNKNOWN_ERROR", + "STATUSCHECK_UNKNOWN", + "STATUSCHECK_UNKNOWN_UNSCHEDULABLE", + "STATUSCHECK_CONTAINER_WAITING_UNKNOWN", + "STATUSCHECK_UNKNOWN_EVENT", + "DEPLOY_UNKNOWN", + "SYNC_UNKNOWN", + "BUILD_UNKNOWN", + "DEVINIT_UNKNOWN", + "CLEANUP_UNKNOWN", + "SYNC_INIT_ERROR", + "DEVINIT_REGISTER_BUILD_DEPS", + "DEVINIT_REGISTER_TEST_DEPS", + "DEVINIT_REGISTER_DEPLOY_DEPS", + "DEVINIT_REGISTER_CONFIG_DEP" + ], + "default": "OK" + }, + { + "name": "event.resourceStatusCheckEvent.actionableErr.message", + "in": "query", + "required": false, + "type": "string" + }, { "name": "event.fileSyncEvent.fileCount", "in": "query", @@ -519,6 +731,59 @@ ], "default": "OK" }, + { + "name": "event.fileSyncEvent.actionableErr.errCode", + "description": " - OK: A default status code for events that do not have an associated phase.\nTypically seen with the DevEndEvent event on success.\n - STATUSCHECK_SUCCESS: Status Check Success\n - BUILD_SUCCESS: Build Success\n - BUILD_PUSH_ACCESS_DENIED: Build error due to push access denied\n - BUILD_PROJECT_NOT_FOUND: Build error due to GCP project not found.\n - STATUSCHECK_IMAGE_PULL_ERR: Container image pull error\n - STATUSCHECK_CONTAINER_CREATING: Container creating error\n - STATUSCHECK_RUN_CONTAINER_ERR: Container run error\n - STATUSCHECK_CONTAINER_TERMINATED: Container is already terminated\n - STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING: Deployment waiting for rollout\n - STATUSCHECK_CONTAINER_RESTARTING: Container restarting error\n - STATUSCHECK_NODE_MEMORY_PRESSURE: Node memory pressure error\n - STATUSCHECK_NODE_DISK_PRESSURE: Node disk pressure error\n - STATUSCHECK_NODE_NETWORK_UNAVAILABLE: Node network unavailable error\n - STATUSCHECK_NODE_PID_PRESSURE: Node PID pressure error\n - STATUSCHECK_NODE_UNSCHEDULABLE: Node unschedulable error\n - STATUSCHECK_NODE_UNREACHABLE: Node unreachable error\n - STATUSCHECK_NODE_NOT_READY: Node not ready error\n - STATUSCHECK_FAILED_SCHEDULING: Scheduler failure error\n - STATUSCHECK_UNHEALTHY: Readiness probe failed\n - STATUSCHECK_KUBECTL_CONNECTION_ERR: Kubectl connection error\n - STATUSCHECK_KUBECTL_PID_KILLED: Kubectl process killed error\n - UNKNOWN_ERROR: Could not determine error and phase\n - STATUSCHECK_UNKNOWN: Status Check error unknown\n - STATUSCHECK_UNKNOWN_UNSCHEDULABLE: Container is unschedulable due to unknown reasons\n - STATUSCHECK_CONTAINER_WAITING_UNKNOWN: Container is waiting due to unknown reason\n - STATUSCHECK_UNKNOWN_EVENT: Container event reason unknown\n - DEPLOY_UNKNOWN: Deploy failed due to unknown reason\n - SYNC_UNKNOWN: SYNC failed due to known reason\n - BUILD_UNKNOWN: Build failed due to unknown reason\n - DEVINIT_UNKNOWN: Dev Init failed due to unknown reason\n - CLEANUP_UNKNOWN: Cleanup failed due to unknown reason\n - SYNC_INIT_ERROR: File Sync Initialize failure\n - DEVINIT_REGISTER_BUILD_DEPS: Failed to configure watcher for build dependencies in dev loop\n - DEVINIT_REGISTER_TEST_DEPS: Failed to configure watcher for test dependencies in dev loop\n - DEVINIT_REGISTER_DEPLOY_DEPS: Failed to configure watcher for deploy dependencies in dev loop\n - DEVINIT_REGISTER_CONFIG_DEP: Failed to configure watcher for Skaffold configuration file.", + "in": "query", + "required": false, + "type": "string", + "enum": [ + "OK", + "STATUSCHECK_SUCCESS", + "BUILD_SUCCESS", + "BUILD_PUSH_ACCESS_DENIED", + "BUILD_PROJECT_NOT_FOUND", + "STATUSCHECK_IMAGE_PULL_ERR", + "STATUSCHECK_CONTAINER_CREATING", + "STATUSCHECK_RUN_CONTAINER_ERR", + "STATUSCHECK_CONTAINER_TERMINATED", + "STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING", + "STATUSCHECK_CONTAINER_RESTARTING", + "STATUSCHECK_NODE_MEMORY_PRESSURE", + "STATUSCHECK_NODE_DISK_PRESSURE", + "STATUSCHECK_NODE_NETWORK_UNAVAILABLE", + "STATUSCHECK_NODE_PID_PRESSURE", + "STATUSCHECK_NODE_UNSCHEDULABLE", + "STATUSCHECK_NODE_UNREACHABLE", + "STATUSCHECK_NODE_NOT_READY", + "STATUSCHECK_FAILED_SCHEDULING", + "STATUSCHECK_UNHEALTHY", + "STATUSCHECK_KUBECTL_CONNECTION_ERR", + "STATUSCHECK_KUBECTL_PID_KILLED", + "UNKNOWN_ERROR", + "STATUSCHECK_UNKNOWN", + "STATUSCHECK_UNKNOWN_UNSCHEDULABLE", + "STATUSCHECK_CONTAINER_WAITING_UNKNOWN", + "STATUSCHECK_UNKNOWN_EVENT", + "DEPLOY_UNKNOWN", + "SYNC_UNKNOWN", + "BUILD_UNKNOWN", + "DEVINIT_UNKNOWN", + "CLEANUP_UNKNOWN", + "SYNC_INIT_ERROR", + "DEVINIT_REGISTER_BUILD_DEPS", + "DEVINIT_REGISTER_TEST_DEPS", + "DEVINIT_REGISTER_DEPLOY_DEPS", + "DEVINIT_REGISTER_CONFIG_DEP" + ], + "default": "OK" + }, + { + "name": "event.fileSyncEvent.actionableErr.message", + "in": "query", + "required": false, + "type": "string" + }, { "name": "event.debuggingContainerEvent.status", "in": "query", @@ -780,6 +1045,24 @@ } } }, + "protoActionableErr": { + "type": "object", + "properties": { + "errCode": { + "$ref": "#/definitions/protoStatusCode" + }, + "message": { + "type": "string" + }, + "suggestions": { + "type": "array", + "items": { + "$ref": "#/definitions/protoSuggestion" + } + } + }, + "description": "`ActionableErr` defines an error occurred along with an optional suggestions" + }, "protoBuildEvent": { "type": "object", "properties": { @@ -794,6 +1077,9 @@ }, "errCode": { "$ref": "#/definitions/protoStatusCode" + }, + "actionableErr": { + "$ref": "#/definitions/protoActionableErr" } }, "description": "`BuildEvent` describes the build status per artifact, and will be emitted by Skaffold anytime a build starts or finishes, successfully or not.\nIf the build fails, an error will be attached to the event." @@ -921,6 +1207,9 @@ }, "errCode": { "$ref": "#/definitions/protoStatusCode" + }, + "actionableErr": { + "$ref": "#/definitions/protoActionableErr" } }, "description": "`DeployEvent` represents the status of a deployment, and is emitted by Skaffold\nanytime a deployment starts or completes, successfully or not." @@ -974,23 +1263,11 @@ "type": "string" }, "err": { - "$ref": "#/definitions/protoErrDef" + "$ref": "#/definitions/protoActionableErr" } }, "description": "`DevLoopEvent` marks the start and end of a dev loop." }, - "protoErrDef": { - "type": "object", - "properties": { - "errCode": { - "$ref": "#/definitions/protoStatusCode" - }, - "message": { - "type": "string" - } - }, - "description": "`ErrDef` defines an error occurred along with an optional suggestions" - }, "protoEvent": { "type": "object", "properties": { @@ -1042,6 +1319,9 @@ }, "errCode": { "$ref": "#/definitions/protoStatusCode" + }, + "actionableErr": { + "$ref": "#/definitions/protoActionableErr" } }, "description": "FileSyncEvent describes the sync status." @@ -1177,6 +1457,9 @@ }, "statusCode": { "$ref": "#/definitions/protoStatusCode" + }, + "actionableErr": { + "$ref": "#/definitions/protoActionableErr" } }, "description": "A Resource StatusCheck Event, indicates progress for each kubernetes deployment.\nFor every resource, there will be exactly one event with `status` *Succeeded* or *Failed* event.\nThere can be multiple events with `status` *Pending*.\nSkaffold polls for resource status every 0.5 second. If the resource status changes, an event with `status` “Pending”, “Complete” and “Failed”\nwill be sent with the new status." @@ -1228,6 +1511,9 @@ }, "errCode": { "$ref": "#/definitions/protoStatusCode" + }, + "actionableErr": { + "$ref": "#/definitions/protoActionableErr" } }, "description": "`StatusCheckEvent` describes if the status check for kubernetes rollout has started, is in progress, has succeeded or failed." @@ -1292,6 +1578,26 @@ "default": "OK", "description": "Enum for Status codes\nThese error codes are prepended by Phase Name e.g.\nBUILD, DEPLOY, STATUSCHECK, DEVINIT\n- OK: A default status code for events that do not have an associated phase.\nTypically seen with the DevEndEvent event on success.\n - STATUSCHECK_SUCCESS: Status Check Success\n - BUILD_SUCCESS: Build Success\n - BUILD_PUSH_ACCESS_DENIED: Build error due to push access denied\n - BUILD_PROJECT_NOT_FOUND: Build error due to GCP project not found.\n - STATUSCHECK_IMAGE_PULL_ERR: Container image pull error\n - STATUSCHECK_CONTAINER_CREATING: Container creating error\n - STATUSCHECK_RUN_CONTAINER_ERR: Container run error\n - STATUSCHECK_CONTAINER_TERMINATED: Container is already terminated\n - STATUSCHECK_DEPLOYMENT_ROLLOUT_PENDING: Deployment waiting for rollout\n - STATUSCHECK_CONTAINER_RESTARTING: Container restarting error\n - STATUSCHECK_NODE_MEMORY_PRESSURE: Node memory pressure error\n - STATUSCHECK_NODE_DISK_PRESSURE: Node disk pressure error\n - STATUSCHECK_NODE_NETWORK_UNAVAILABLE: Node network unavailable error\n - STATUSCHECK_NODE_PID_PRESSURE: Node PID pressure error\n - STATUSCHECK_NODE_UNSCHEDULABLE: Node unschedulable error\n - STATUSCHECK_NODE_UNREACHABLE: Node unreachable error\n - STATUSCHECK_NODE_NOT_READY: Node not ready error\n - STATUSCHECK_FAILED_SCHEDULING: Scheduler failure error\n - STATUSCHECK_UNHEALTHY: Readiness probe failed\n - STATUSCHECK_KUBECTL_CONNECTION_ERR: Kubectl connection error\n - STATUSCHECK_KUBECTL_PID_KILLED: Kubectl process killed error\n - UNKNOWN_ERROR: Could not determine error and phase\n - STATUSCHECK_UNKNOWN: Status Check error unknown\n - STATUSCHECK_UNKNOWN_UNSCHEDULABLE: Container is unschedulable due to unknown reasons\n - STATUSCHECK_CONTAINER_WAITING_UNKNOWN: Container is waiting due to unknown reason\n - STATUSCHECK_UNKNOWN_EVENT: Container event reason unknown\n - DEPLOY_UNKNOWN: Deploy failed due to unknown reason\n - SYNC_UNKNOWN: SYNC failed due to known reason\n - BUILD_UNKNOWN: Build failed due to unknown reason\n - DEVINIT_UNKNOWN: Dev Init failed due to unknown reason\n - CLEANUP_UNKNOWN: Cleanup failed due to unknown reason\n - SYNC_INIT_ERROR: File Sync Initialize failure\n - DEVINIT_REGISTER_BUILD_DEPS: Failed to configure watcher for build dependencies in dev loop\n - DEVINIT_REGISTER_TEST_DEPS: Failed to configure watcher for test dependencies in dev loop\n - DEVINIT_REGISTER_DEPLOY_DEPS: Failed to configure watcher for deploy dependencies in dev loop\n - DEVINIT_REGISTER_CONFIG_DEP: Failed to configure watcher for Skaffold configuration file." }, + "protoSuggestion": { + "type": "object", + "properties": { + "suggestionCode": { + "$ref": "#/definitions/protoSuggestionCode" + }, + "action": { + "type": "string" + } + }, + "description": "Suggestion defines the action a user needs to recover from an error." + }, + "protoSuggestionCode": { + "type": "string", + "enum": [ + "NIL" + ], + "default": "NIL", + "description": "Enum for Suggestion codes\n- NIL: default nil suggestion.\nThis is usually set when no error happens." + }, "protoTriggerState": { "type": "object", "properties": { diff --git a/docs/content/en/docs/references/api/grpc.md b/docs/content/en/docs/references/api/grpc.md index 4db3674fbbd..78f633b7c6a 100644 --- a/docs/content/en/docs/references/api/grpc.md +++ b/docs/content/en/docs/references/api/grpc.md @@ -52,6 +52,23 @@ Describes all the methods for the Skaffold API + +#### ActionableErr +`ActionableErr` defines an error occurred along with an optional suggestions + + +| Field | Type | Label | Description | +| ----- | ---- | ----- | ----------- | +| errCode | [StatusCode](#proto.StatusCode) | | error code representing the error | +| message | [string](#string) | | message describing the error. | +| suggestions | [Suggestion](#proto.Suggestion) | repeated | list of suggestions | + + + + + + + #### BuildEvent `BuildEvent` describes the build status per artifact, and will be emitted by Skaffold anytime a build starts or finishes, successfully or not. @@ -62,8 +79,9 @@ If the build fails, an error will be attached to the event. | ----- | ---- | ----- | ----------- | | artifact | [string](#string) | | artifact name | | status | [string](#string) | | artifact build status oneof: InProgress, Completed, Failed | -| err | [string](#string) | | error when build status is Failed. | -| errCode | [StatusCode](#proto.StatusCode) | | status code representing success or failure | +| err | [string](#string) | | Deprecated. Use actionableErr.message. error when build status is Failed. | +| errCode | [StatusCode](#proto.StatusCode) | | Deprecated. Use actionableErr.errCode. status code representing success or failure | +| actionableErr | [ActionableErr](#proto.ActionableErr) | | actionable error message | @@ -200,8 +218,9 @@ anytime a deployment starts or completes, successfully or not. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | | status | [string](#string) | | deployment status oneof: InProgress, Completed, Failed | -| err | [string](#string) | | error when status is Failed | -| errCode | [StatusCode](#proto.StatusCode) | | status code representing success or failure | +| err | [string](#string) | | Deprecated. Use actionableErr.message. error when status is Failed | +| errCode | [StatusCode](#proto.StatusCode) | | Deprecated. Use actionableErr.errCode. status code representing success or failure | +| actionableErr | [ActionableErr](#proto.ActionableErr) | | actionable error message | @@ -266,23 +285,7 @@ anytime a deployment starts or completes, successfully or not. | ----- | ---- | ----- | ----------- | | iteration | [int32](#int32) | | dev loop iteration. 0 represents initialization loop. | | status | [string](#string) | | dev loop status oneof: In Progress, Completed, Failed | -| err | [ErrDef](#proto.ErrDef) | | actionable error message | - - - - - - - - -#### ErrDef -`ErrDef` defines an error occurred along with an optional suggestions - - -| Field | Type | Label | Description | -| ----- | ---- | ----- | ----------- | -| errCode | [StatusCode](#proto.StatusCode) | | error code representing the error | -| message | [string](#string) | | message describing the error. | +| err | [ActionableErr](#proto.ActionableErr) | | actionable error message | @@ -324,8 +327,9 @@ FileSyncEvent describes the sync status. | fileCount | [int32](#int32) | | number of files synced | | image | [string](#string) | | the container image to which files are sycned. | | status | [string](#string) | | status of file sync. one of: Not Started, In progress, Succeeded, Failed. | -| err | [string](#string) | | error in case of status failed. | -| errCode | [StatusCode](#proto.StatusCode) | | status code representing success or failure | +| err | [string](#string) | | Deprecated. Use actionableErr.message. error in case of status failed. | +| errCode | [StatusCode](#proto.StatusCode) | | Deprecated. Use actionableErr.errCode. status code representing success or failure | +| actionableErr | [ActionableErr](#proto.ActionableErr) | | actionable error message | @@ -484,8 +488,9 @@ will be sent with the new status. | resource | [string](#string) | | | | status | [string](#string) | | | | message | [string](#string) | | | -| err | [string](#string) | | | +| err | [string](#string) | | Deprecated. Use actionableErr.message. | | statusCode | [StatusCode](#proto.StatusCode) | | | +| actionableErr | [ActionableErr](#proto.ActionableErr) | | actionable error message | @@ -569,8 +574,9 @@ will be sent with the new status. | ----- | ---- | ----- | ----------- | | status | [string](#string) | | | | message | [string](#string) | | | -| err | [string](#string) | | | -| errCode | [StatusCode](#proto.StatusCode) | | status code representing success or failure | +| err | [string](#string) | | Deprecated. Use actionableErr.message. | +| errCode | [StatusCode](#proto.StatusCode) | | Deprecated. Use actionableErr.errCode. status code representing success or failure | +| actionableErr | [ActionableErr](#proto.ActionableErr) | | actionable error message | @@ -610,6 +616,22 @@ will be sent with the new status. + +#### Suggestion +Suggestion defines the action a user needs to recover from an error. + + +| Field | Type | Label | Description | +| ----- | ---- | ----- | ----------- | +| suggestionCode | [SuggestionCode](#proto.SuggestionCode) | | code representing a suggestion | +| action | [string](#string) | | action represents the suggestion action | + + + + + + + #### TriggerRequest @@ -763,6 +785,17 @@ BUILD, DEPLOY, STATUSCHECK, DEVINIT | DEVINIT_REGISTER_CONFIG_DEP | 704 | Failed to configure watcher for Skaffold configuration file. | + + + +### SuggestionCode +Enum for Suggestion codes + +| Name | Number | Description | +| ---- | ------ | ----------- | +| NIL | 0 | default nil suggestion. This is usually set when no error happens. | + + diff --git a/pkg/skaffold/errors/errors.go b/pkg/skaffold/errors/errors.go index 44bcf265f8e..875091e4b37 100644 --- a/pkg/skaffold/errors/errors.go +++ b/pkg/skaffold/errors/errors.go @@ -40,7 +40,29 @@ var ( type Phase string -func ErrorCodeFromError(phase Phase, _ error) proto.StatusCode { +// ActionableErr returns an actionable error message with suggestions +func ActionableErr(phase Phase, err error) *proto.ActionableErr { + aiErr := proto.ActionableErr{ + ErrCode: defaultErrorCodeFromError(phase), + Message: err.Error(), + Suggestions: nil, + } + + return &aiErr +} + +func ShowAIError(err error, opts config.SkaffoldOptions) error { + for _, v := range knownBuildProblems { + if v.regexp.MatchString(err.Error()) { + if s := v.suggestion(opts); s != "" { + return fmt.Errorf("%s. %s", v.description, s) + } + } + } + return ErrNoSuggestionFound +} + +func defaultErrorCodeFromError(phase Phase) proto.StatusCode { switch phase { case Build: return proto.StatusCode_BUILD_UNKNOWN @@ -57,14 +79,3 @@ func ErrorCodeFromError(phase Phase, _ error) proto.StatusCode { } return proto.StatusCode_UNKNOWN_ERROR } - -func ShowAIError(err error, opts config.SkaffoldOptions) error { - for _, v := range knownBuildProblems { - if v.regexp.MatchString(err.Error()) { - if s := v.suggestion(opts); s != "" { - return fmt.Errorf("%s. %s", v.description, s) - } - } - } - return ErrNoSuggestionFound -} diff --git a/pkg/skaffold/event/event.go b/pkg/skaffold/event/event.go index e624c61ee27..fb136cb0a6b 100644 --- a/pkg/skaffold/event/event.go +++ b/pkg/skaffold/event/event.go @@ -169,8 +169,11 @@ func DeployInProgress() { // DeployFailed notifies that non-fatal errors were encountered during a deployment. func DeployFailed(err error) { - statusCode := sErrors.ErrorCodeFromError(sErrors.Deploy, err) - handler.handleDeployEvent(&proto.DeployEvent{Status: Failed, Err: err.Error(), ErrCode: statusCode}) + aiErr := sErrors.ActionableErr(sErrors.Deploy, err) + handler.handleDeployEvent(&proto.DeployEvent{Status: Failed, + Err: err.Error(), + ErrCode: aiErr.ErrCode, + ActionableErr: aiErr}) } // DeployEvent notifies that a deployment of non fatal interesting errors during deploy. @@ -193,12 +196,12 @@ func statusCheckEventSucceeded() { } func statusCheckEventFailed(err error) { - statusCode := sErrors.ErrorCodeFromError(sErrors.StatusCheck, err) + aiErr := sErrors.ActionableErr(sErrors.StatusCheck, err) handler.handleStatusCheckEvent(&proto.StatusCheckEvent{ - Status: Failed, - Err: err.Error(), - ErrCode: statusCode, - }) + Status: Failed, + Err: err.Error(), + ErrCode: aiErr.ErrCode, + ActionableErr: aiErr}) } func StatusCheckEventStarted() { @@ -237,7 +240,10 @@ func resourceStatusCheckEventFailed(r string, statusCode proto.StatusCode, err e Status: Failed, Err: err.Error(), StatusCode: statusCode, - }) + ActionableErr: &proto.ActionableErr{ + ErrCode: statusCode, + Message: err.Error(), + }}) } func ResourceStatusCheckEventUpdated(r string, statusCode proto.StatusCode, status string) { @@ -261,8 +267,13 @@ func BuildInProgress(imageName string) { // BuildFailed notifies that a build has failed. func BuildFailed(imageName string, err error) { - statusCode := sErrors.ErrorCodeFromError(sErrors.Build, err) - handler.handleBuildEvent(&proto.BuildEvent{Artifact: imageName, Status: Failed, Err: err.Error(), ErrCode: statusCode}) + aiErr := sErrors.ActionableErr(sErrors.Build, err) + handler.handleBuildEvent(&proto.BuildEvent{ + Artifact: imageName, + Status: Failed, + Err: err.Error(), + ErrCode: aiErr.ErrCode, + ActionableErr: aiErr}) } // BuildComplete notifies that a build has completed. @@ -276,20 +287,21 @@ func DevLoopInProgress(i int) { } // DevLoopFailed notifies that a dev loop has failed with an error code -func DevLoopFailedWithErrorCode(i int, errCode proto.StatusCode, err error) { +func DevLoopFailedWithErrorCode(i int, statusCode proto.StatusCode, err error) { + ai := &proto.ActionableErr{ + ErrCode: statusCode, + Message: err.Error(), + } handler.handleDevLoopEvent(&proto.DevLoopEvent{ Iteration: int32(i), Status: Failed, - Err: &proto.ErrDef{ - ErrCode: errCode, - Message: err.Error(), - }}) + Err: ai}) } // DevLoopFailed notifies that a dev loop has failed in a given phase func DevLoopFailedInPhase(iteration int, phase sErrors.Phase, err error) { - statusCode := sErrors.ErrorCodeFromError(phase, err) - DevLoopFailedWithErrorCode(iteration, statusCode, err) + ai := sErrors.ActionableErr(phase, err) + DevLoopFailedWithErrorCode(iteration, ai.ErrCode, err) } // DevLoopComplete notifies that a dev loop has completed. @@ -304,8 +316,9 @@ func FileSyncInProgress(fileCount int, image string) { // FileSyncFailed notifies that a file sync has failed. func FileSyncFailed(fileCount int, image string, err error) { - statusCode := sErrors.ErrorCodeFromError(sErrors.FileSync, err) - handler.handleFileSyncEvent(&proto.FileSyncEvent{FileCount: int32(fileCount), Image: image, Status: Failed, Err: err.Error(), ErrCode: statusCode}) + aiErr := sErrors.ActionableErr(sErrors.FileSync, err) + handler.handleFileSyncEvent(&proto.FileSyncEvent{FileCount: int32(fileCount), Image: image, Status: Failed, + Err: err.Error(), ErrCode: aiErr.ErrCode, ActionableErr: aiErr}) } // FileSyncSucceeded notifies that a file sync has succeeded. diff --git a/proto/skaffold.pb.go b/proto/skaffold.pb.go index 2de8a73cbba..e652d317e8e 100644 --- a/proto/skaffold.pb.go +++ b/proto/skaffold.pb.go @@ -354,6 +354,31 @@ func (StatusCode) EnumDescriptor() ([]byte, []int) { return fileDescriptor_4f2d38e344f9dbf5, []int{4} } +// Enum for Suggestion codes +type SuggestionCode int32 + +const ( + // default nil suggestion. + // This is usually set when no error happens. + SuggestionCode_NIL SuggestionCode = 0 +) + +var SuggestionCode_name = map[int32]string{ + 0: "NIL", +} + +var SuggestionCode_value = map[string]int32{ + "NIL": 0, +} + +func (x SuggestionCode) String() string { + return proto.EnumName(SuggestionCode_name, int32(x)) +} + +func (SuggestionCode) EnumDescriptor() ([]byte, []int) { + return fileDescriptor_4f2d38e344f9dbf5, []int{5} +} + type StateResponse struct { State *State `protobuf:"bytes,1,opt,name=state,proto3" json:"state,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` @@ -1214,12 +1239,12 @@ func (*Event) XXX_OneofWrappers() []interface{} { // `DevLoopEvent` marks the start and end of a dev loop. type DevLoopEvent struct { - Iteration int32 `protobuf:"varint,1,opt,name=iteration,proto3" json:"iteration,omitempty"` - Status string `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"` - Err *ErrDef `protobuf:"bytes,3,opt,name=err,proto3" json:"err,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + Iteration int32 `protobuf:"varint,1,opt,name=iteration,proto3" json:"iteration,omitempty"` + Status string `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"` + Err *ActionableErr `protobuf:"bytes,3,opt,name=err,proto3" json:"err,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *DevLoopEvent) Reset() { *m = DevLoopEvent{} } @@ -1261,61 +1286,69 @@ func (m *DevLoopEvent) GetStatus() string { return "" } -func (m *DevLoopEvent) GetErr() *ErrDef { +func (m *DevLoopEvent) GetErr() *ActionableErr { if m != nil { return m.Err } return nil } -// `ErrDef` defines an error occurred along with an optional suggestions -type ErrDef struct { - ErrCode StatusCode `protobuf:"varint,1,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` - Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` +// `ActionableErr` defines an error occurred along with an optional suggestions +type ActionableErr struct { + ErrCode StatusCode `protobuf:"varint,1,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` + Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"` + Suggestions []*Suggestion `protobuf:"bytes,3,rep,name=suggestions,proto3" json:"suggestions,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } -func (m *ErrDef) Reset() { *m = ErrDef{} } -func (m *ErrDef) String() string { return proto.CompactTextString(m) } -func (*ErrDef) ProtoMessage() {} -func (*ErrDef) Descriptor() ([]byte, []int) { +func (m *ActionableErr) Reset() { *m = ActionableErr{} } +func (m *ActionableErr) String() string { return proto.CompactTextString(m) } +func (*ActionableErr) ProtoMessage() {} +func (*ActionableErr) Descriptor() ([]byte, []int) { return fileDescriptor_4f2d38e344f9dbf5, []int{13} } -func (m *ErrDef) XXX_Unmarshal(b []byte) error { - return xxx_messageInfo_ErrDef.Unmarshal(m, b) +func (m *ActionableErr) XXX_Unmarshal(b []byte) error { + return xxx_messageInfo_ActionableErr.Unmarshal(m, b) } -func (m *ErrDef) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { - return xxx_messageInfo_ErrDef.Marshal(b, m, deterministic) +func (m *ActionableErr) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + return xxx_messageInfo_ActionableErr.Marshal(b, m, deterministic) } -func (m *ErrDef) XXX_Merge(src proto.Message) { - xxx_messageInfo_ErrDef.Merge(m, src) +func (m *ActionableErr) XXX_Merge(src proto.Message) { + xxx_messageInfo_ActionableErr.Merge(m, src) } -func (m *ErrDef) XXX_Size() int { - return xxx_messageInfo_ErrDef.Size(m) +func (m *ActionableErr) XXX_Size() int { + return xxx_messageInfo_ActionableErr.Size(m) } -func (m *ErrDef) XXX_DiscardUnknown() { - xxx_messageInfo_ErrDef.DiscardUnknown(m) +func (m *ActionableErr) XXX_DiscardUnknown() { + xxx_messageInfo_ActionableErr.DiscardUnknown(m) } -var xxx_messageInfo_ErrDef proto.InternalMessageInfo +var xxx_messageInfo_ActionableErr proto.InternalMessageInfo -func (m *ErrDef) GetErrCode() StatusCode { +func (m *ActionableErr) GetErrCode() StatusCode { if m != nil { return m.ErrCode } return StatusCode_OK } -func (m *ErrDef) GetMessage() string { +func (m *ActionableErr) GetMessage() string { if m != nil { return m.Message } return "" } +func (m *ActionableErr) GetSuggestions() []*Suggestion { + if m != nil { + return m.Suggestions + } + return nil +} + // `MetaEvent` provides general information regarding Skaffold type MetaEvent struct { // entry, for example: `"Starting Skaffold: {Version:v0.39.0-16-g5bb7c9e0 ConfigVersion:skaffold/v1 GitVersion: GitCommit:5bb7c9e078e4d522a5ffc42a2f1274fd17d75902 GitTreeState:dirty BuildDate01:29Z GoVersion:go1.13rc1 Compiler:gc Platform:linux/amd64}"` @@ -1369,13 +1402,14 @@ func (m *MetaEvent) GetMetadata() *Metadata { // `BuildEvent` describes the build status per artifact, and will be emitted by Skaffold anytime a build starts or finishes, successfully or not. // If the build fails, an error will be attached to the event. type BuildEvent struct { - Artifact string `protobuf:"bytes,1,opt,name=artifact,proto3" json:"artifact,omitempty"` - Status string `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"` - Err string `protobuf:"bytes,3,opt,name=err,proto3" json:"err,omitempty"` - ErrCode StatusCode `protobuf:"varint,4,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + Artifact string `protobuf:"bytes,1,opt,name=artifact,proto3" json:"artifact,omitempty"` + Status string `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"` + Err string `protobuf:"bytes,3,opt,name=err,proto3" json:"err,omitempty"` + ErrCode StatusCode `protobuf:"varint,4,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` + ActionableErr *ActionableErr `protobuf:"bytes,5,opt,name=actionableErr,proto3" json:"actionableErr,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *BuildEvent) Reset() { *m = BuildEvent{} } @@ -1431,15 +1465,23 @@ func (m *BuildEvent) GetErrCode() StatusCode { return StatusCode_OK } +func (m *BuildEvent) GetActionableErr() *ActionableErr { + if m != nil { + return m.ActionableErr + } + return nil +} + // `DeployEvent` represents the status of a deployment, and is emitted by Skaffold // anytime a deployment starts or completes, successfully or not. type DeployEvent struct { - Status string `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"` - Err string `protobuf:"bytes,2,opt,name=err,proto3" json:"err,omitempty"` - ErrCode StatusCode `protobuf:"varint,3,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + Status string `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"` + Err string `protobuf:"bytes,2,opt,name=err,proto3" json:"err,omitempty"` + ErrCode StatusCode `protobuf:"varint,3,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` + ActionableErr *ActionableErr `protobuf:"bytes,4,opt,name=actionableErr,proto3" json:"actionableErr,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *DeployEvent) Reset() { *m = DeployEvent{} } @@ -1488,15 +1530,23 @@ func (m *DeployEvent) GetErrCode() StatusCode { return StatusCode_OK } +func (m *DeployEvent) GetActionableErr() *ActionableErr { + if m != nil { + return m.ActionableErr + } + return nil +} + // `StatusCheckEvent` describes if the status check for kubernetes rollout has started, is in progress, has succeeded or failed. type StatusCheckEvent struct { - Status string `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"` - Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"` - Err string `protobuf:"bytes,3,opt,name=err,proto3" json:"err,omitempty"` - ErrCode StatusCode `protobuf:"varint,4,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + Status string `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"` + Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"` + Err string `protobuf:"bytes,3,opt,name=err,proto3" json:"err,omitempty"` + ErrCode StatusCode `protobuf:"varint,4,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` + ActionableErr *ActionableErr `protobuf:"bytes,5,opt,name=actionableErr,proto3" json:"actionableErr,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *StatusCheckEvent) Reset() { *m = StatusCheckEvent{} } @@ -1552,20 +1602,28 @@ func (m *StatusCheckEvent) GetErrCode() StatusCode { return StatusCode_OK } +func (m *StatusCheckEvent) GetActionableErr() *ActionableErr { + if m != nil { + return m.ActionableErr + } + return nil +} + // A Resource StatusCheck Event, indicates progress for each kubernetes deployment. // For every resource, there will be exactly one event with `status` *Succeeded* or *Failed* event. // There can be multiple events with `status` *Pending*. // Skaffold polls for resource status every 0.5 second. If the resource status changes, an event with `status` “Pending”, “Complete” and “Failed” // will be sent with the new status. type ResourceStatusCheckEvent struct { - Resource string `protobuf:"bytes,1,opt,name=resource,proto3" json:"resource,omitempty"` - Status string `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"` - Message string `protobuf:"bytes,3,opt,name=message,proto3" json:"message,omitempty"` - Err string `protobuf:"bytes,4,opt,name=err,proto3" json:"err,omitempty"` - StatusCode StatusCode `protobuf:"varint,5,opt,name=statusCode,proto3,enum=proto.StatusCode" json:"statusCode,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + Resource string `protobuf:"bytes,1,opt,name=resource,proto3" json:"resource,omitempty"` + Status string `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"` + Message string `protobuf:"bytes,3,opt,name=message,proto3" json:"message,omitempty"` + Err string `protobuf:"bytes,4,opt,name=err,proto3" json:"err,omitempty"` + StatusCode StatusCode `protobuf:"varint,5,opt,name=statusCode,proto3,enum=proto.StatusCode" json:"statusCode,omitempty"` + ActionableErr *ActionableErr `protobuf:"bytes,6,opt,name=actionableErr,proto3" json:"actionableErr,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *ResourceStatusCheckEvent) Reset() { *m = ResourceStatusCheckEvent{} } @@ -1628,6 +1686,13 @@ func (m *ResourceStatusCheckEvent) GetStatusCode() StatusCode { return StatusCode_OK } +func (m *ResourceStatusCheckEvent) GetActionableErr() *ActionableErr { + if m != nil { + return m.ActionableErr + } + return nil +} + // PortEvent Event describes each port forwarding event. type PortEvent struct { LocalPort int32 `protobuf:"varint,1,opt,name=localPort,proto3" json:"localPort,omitempty"` @@ -1734,14 +1799,15 @@ func (m *PortEvent) GetAddress() string { // FileSyncEvent describes the sync status. type FileSyncEvent struct { - FileCount int32 `protobuf:"varint,1,opt,name=fileCount,proto3" json:"fileCount,omitempty"` - Image string `protobuf:"bytes,2,opt,name=image,proto3" json:"image,omitempty"` - Status string `protobuf:"bytes,3,opt,name=status,proto3" json:"status,omitempty"` - Err string `protobuf:"bytes,4,opt,name=err,proto3" json:"err,omitempty"` - ErrCode StatusCode `protobuf:"varint,5,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + FileCount int32 `protobuf:"varint,1,opt,name=fileCount,proto3" json:"fileCount,omitempty"` + Image string `protobuf:"bytes,2,opt,name=image,proto3" json:"image,omitempty"` + Status string `protobuf:"bytes,3,opt,name=status,proto3" json:"status,omitempty"` + Err string `protobuf:"bytes,4,opt,name=err,proto3" json:"err,omitempty"` + ErrCode StatusCode `protobuf:"varint,5,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` + ActionableErr *ActionableErr `protobuf:"bytes,6,opt,name=actionableErr,proto3" json:"actionableErr,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *FileSyncEvent) Reset() { *m = FileSyncEvent{} } @@ -1804,6 +1870,13 @@ func (m *FileSyncEvent) GetErrCode() StatusCode { return StatusCode_OK } +func (m *FileSyncEvent) GetActionableErr() *ActionableErr { + if m != nil { + return m.ActionableErr + } + return nil +} + // DebuggingContainerEvent is raised when a debugging container is started or terminated type DebuggingContainerEvent struct { Status string `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"` @@ -2156,12 +2229,61 @@ func (m *Intent) GetDeploy() bool { return false } +// Suggestion defines the action a user needs to recover from an error. +type Suggestion struct { + SuggestionCode SuggestionCode `protobuf:"varint,1,opt,name=suggestionCode,proto3,enum=proto.SuggestionCode" json:"suggestionCode,omitempty"` + Action string `protobuf:"bytes,2,opt,name=action,proto3" json:"action,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` +} + +func (m *Suggestion) Reset() { *m = Suggestion{} } +func (m *Suggestion) String() string { return proto.CompactTextString(m) } +func (*Suggestion) ProtoMessage() {} +func (*Suggestion) Descriptor() ([]byte, []int) { + return fileDescriptor_4f2d38e344f9dbf5, []int{27} +} + +func (m *Suggestion) XXX_Unmarshal(b []byte) error { + return xxx_messageInfo_Suggestion.Unmarshal(m, b) +} +func (m *Suggestion) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + return xxx_messageInfo_Suggestion.Marshal(b, m, deterministic) +} +func (m *Suggestion) XXX_Merge(src proto.Message) { + xxx_messageInfo_Suggestion.Merge(m, src) +} +func (m *Suggestion) XXX_Size() int { + return xxx_messageInfo_Suggestion.Size(m) +} +func (m *Suggestion) XXX_DiscardUnknown() { + xxx_messageInfo_Suggestion.DiscardUnknown(m) +} + +var xxx_messageInfo_Suggestion proto.InternalMessageInfo + +func (m *Suggestion) GetSuggestionCode() SuggestionCode { + if m != nil { + return m.SuggestionCode + } + return SuggestionCode_NIL +} + +func (m *Suggestion) GetAction() string { + if m != nil { + return m.Action + } + return "" +} + func init() { proto.RegisterEnum("proto.BuilderType", BuilderType_name, BuilderType_value) proto.RegisterEnum("proto.BuildType", BuildType_name, BuildType_value) proto.RegisterEnum("proto.DeployerType", DeployerType_name, DeployerType_value) proto.RegisterEnum("proto.ClusterType", ClusterType_name, ClusterType_value) proto.RegisterEnum("proto.StatusCode", StatusCode_name, StatusCode_value) + proto.RegisterEnum("proto.SuggestionCode", SuggestionCode_name, SuggestionCode_value) proto.RegisterType((*StateResponse)(nil), "proto.StateResponse") proto.RegisterType((*Response)(nil), "proto.Response") proto.RegisterType((*Request)(nil), "proto.Request") @@ -2182,7 +2304,7 @@ func init() { proto.RegisterType((*FileSyncState)(nil), "proto.FileSyncState") proto.RegisterType((*Event)(nil), "proto.Event") proto.RegisterType((*DevLoopEvent)(nil), "proto.DevLoopEvent") - proto.RegisterType((*ErrDef)(nil), "proto.ErrDef") + proto.RegisterType((*ActionableErr)(nil), "proto.ActionableErr") proto.RegisterType((*MetaEvent)(nil), "proto.MetaEvent") proto.RegisterType((*BuildEvent)(nil), "proto.BuildEvent") proto.RegisterType((*DeployEvent)(nil), "proto.DeployEvent") @@ -2197,169 +2319,176 @@ func init() { proto.RegisterType((*TriggerRequest)(nil), "proto.TriggerRequest") proto.RegisterType((*TriggerState)(nil), "proto.TriggerState") proto.RegisterType((*Intent)(nil), "proto.Intent") + proto.RegisterType((*Suggestion)(nil), "proto.Suggestion") } func init() { proto.RegisterFile("skaffold.proto", fileDescriptor_4f2d38e344f9dbf5) } var fileDescriptor_4f2d38e344f9dbf5 = []byte{ - // 2502 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xa4, 0x59, 0x5b, 0x6f, 0x1b, 0xc7, - 0xf5, 0x17, 0xb9, 0x24, 0x45, 0x1e, 0x5d, 0xbc, 0x1a, 0x5b, 0x36, 0x43, 0x3b, 0xb6, 0xb2, 0x7f, - 0xdb, 0x71, 0x94, 0xfc, 0xa5, 0x38, 0x29, 0x8a, 0xd4, 0x4d, 0x5a, 0x50, 0xcb, 0xb1, 0xb8, 0x26, - 0xb5, 0x14, 0x86, 0xcb, 0xa4, 0x0e, 0x50, 0x10, 0x6b, 0x72, 0xc4, 0x10, 0x26, 0xb9, 0xec, 0x72, - 0xa9, 0x54, 0x2f, 0x2d, 0xd0, 0x7e, 0x81, 0xb6, 0x69, 0x7a, 0x09, 0xfa, 0xda, 0xb7, 0x24, 0xed, - 0x6b, 0x1f, 0x7a, 0x79, 0x6b, 0xfb, 0xdc, 0xa7, 0x3e, 0x16, 0x48, 0xbf, 0x41, 0xd2, 0x7b, 0x81, - 0x62, 0x6e, 0x7b, 0xe1, 0xc5, 0x82, 0x91, 0x27, 0x71, 0xce, 0xfc, 0xce, 0xef, 0x9c, 0x39, 0x73, - 0xe6, 0x9c, 0x99, 0x15, 0x6c, 0x4e, 0x1e, 0xbb, 0x27, 0x27, 0xde, 0xa0, 0xbb, 0x37, 0xf6, 0xbd, - 0xc0, 0x43, 0x59, 0xfe, 0xa7, 0x74, 0xad, 0xe7, 0x79, 0xbd, 0x01, 0xdd, 0x77, 0xc7, 0xfd, 0x7d, - 0x77, 0x34, 0xf2, 0x02, 0x37, 0xe8, 0x7b, 0xa3, 0x89, 0x00, 0x95, 0x6e, 0xc8, 0x59, 0x3e, 0x7a, - 0x34, 0x3d, 0xd9, 0x0f, 0xfa, 0x43, 0x3a, 0x09, 0xdc, 0xe1, 0x58, 0x02, 0xae, 0xce, 0x02, 0xe8, - 0x70, 0x1c, 0x9c, 0x89, 0x49, 0xe3, 0x55, 0xd8, 0x68, 0x06, 0x6e, 0x40, 0x09, 0x9d, 0x8c, 0xbd, - 0xd1, 0x84, 0x22, 0x03, 0xb2, 0x13, 0x26, 0x28, 0xa6, 0x76, 0x52, 0x77, 0xd6, 0x5e, 0x59, 0x17, - 0xb8, 0x3d, 0x01, 0x12, 0x53, 0xc6, 0x35, 0xc8, 0x87, 0x78, 0x1d, 0xb4, 0xe1, 0xa4, 0xc7, 0xd1, - 0x05, 0xc2, 0x7e, 0x1a, 0xcf, 0xc2, 0x2a, 0xa1, 0xdf, 0x98, 0xd2, 0x49, 0x80, 0x10, 0x64, 0x46, - 0xee, 0x90, 0xca, 0x59, 0xfe, 0xdb, 0x78, 0x3f, 0x03, 0x59, 0xce, 0x86, 0xee, 0x02, 0x3c, 0x9a, - 0xf6, 0x07, 0xdd, 0x66, 0xcc, 0xde, 0x96, 0xb4, 0x77, 0x10, 0x4e, 0x90, 0x18, 0x08, 0x7d, 0x01, - 0xd6, 0xba, 0x74, 0x3c, 0xf0, 0xce, 0x84, 0x4e, 0x9a, 0xeb, 0x20, 0xa9, 0x53, 0x89, 0x66, 0x48, - 0x1c, 0x86, 0xaa, 0xb0, 0x79, 0xe2, 0xf9, 0xef, 0xba, 0x7e, 0x97, 0x76, 0x8f, 0x3d, 0x3f, 0x98, - 0x14, 0x33, 0x3b, 0xda, 0x9d, 0xb5, 0x57, 0x76, 0xe2, 0x8b, 0xdb, 0xbb, 0x9f, 0x80, 0xe0, 0x51, - 0xe0, 0x9f, 0x91, 0x19, 0x3d, 0x64, 0x82, 0xce, 0x42, 0x30, 0x9d, 0x98, 0xef, 0xd0, 0xce, 0x63, - 0xe1, 0x44, 0x96, 0x3b, 0x71, 0x25, 0xc6, 0x15, 0x9f, 0x26, 0x73, 0x0a, 0xe8, 0x1e, 0x6c, 0x9c, - 0xf4, 0x07, 0xb4, 0x79, 0x36, 0xea, 0x08, 0x86, 0x1c, 0x67, 0xb8, 0x24, 0x19, 0xee, 0xc7, 0xe7, - 0x48, 0x12, 0x8a, 0x8e, 0xe1, 0x62, 0x97, 0x3e, 0x9a, 0xf6, 0x7a, 0xfd, 0x51, 0xcf, 0xf4, 0x46, - 0x81, 0xdb, 0x1f, 0x51, 0x7f, 0x52, 0x5c, 0xe5, 0xeb, 0xb9, 0x1e, 0x06, 0x62, 0x16, 0x81, 0x4f, - 0xe9, 0x28, 0x20, 0x8b, 0x54, 0xd1, 0x8b, 0x90, 0x1f, 0xd2, 0xc0, 0xed, 0xba, 0x81, 0x5b, 0xcc, - 0x73, 0x47, 0x2e, 0x48, 0x9a, 0x23, 0x29, 0x26, 0x21, 0xa0, 0xd4, 0x84, 0x8b, 0x0b, 0xc2, 0xc4, - 0x92, 0xe0, 0x31, 0x3d, 0xe3, 0x5b, 0x98, 0x25, 0xec, 0x27, 0xba, 0x0d, 0xd9, 0x53, 0x77, 0x30, - 0x55, 0x5b, 0xa4, 0x4b, 0x4a, 0xa6, 0x23, 0x7c, 0x11, 0xd3, 0xf7, 0xd2, 0xaf, 0xa5, 0x1e, 0x64, - 0xf2, 0x9a, 0x9e, 0x31, 0xfe, 0x9a, 0x82, 0xbc, 0xb2, 0x88, 0x76, 0x21, 0xcb, 0x77, 0x5d, 0x66, - 0xc5, 0xa5, 0x78, 0x56, 0x84, 0x6e, 0x09, 0x08, 0xfa, 0x7f, 0xc8, 0x89, 0xcd, 0x96, 0xb6, 0xb6, - 0x13, 0xe9, 0x10, 0xa2, 0x25, 0x08, 0x7d, 0x15, 0xc0, 0xed, 0x76, 0xfb, 0xec, 0x08, 0xb9, 0x83, - 0x62, 0x87, 0x07, 0xee, 0xc6, 0xcc, 0x8a, 0xf7, 0xca, 0x21, 0x42, 0xe4, 0x41, 0x4c, 0xa5, 0xf4, - 0x06, 0x5c, 0x98, 0x99, 0x8e, 0xaf, 0xbf, 0x20, 0xd6, 0x7f, 0x29, 0xbe, 0xfe, 0x42, 0x6c, 0xb5, - 0xc6, 0x67, 0x69, 0xd8, 0x48, 0xac, 0x03, 0xbd, 0x04, 0x5b, 0xa3, 0xe9, 0xf0, 0x11, 0xf5, 0x1b, - 0x27, 0x65, 0x3f, 0xe8, 0x9f, 0xb8, 0x9d, 0x60, 0x22, 0x63, 0x39, 0x3f, 0x81, 0xde, 0x80, 0x3c, - 0x5f, 0x37, 0xdb, 0xf6, 0x34, 0xf7, 0xfe, 0xb9, 0x45, 0xd1, 0xd9, 0xb3, 0x86, 0x6e, 0x8f, 0x1e, - 0x08, 0x24, 0x09, 0x55, 0xd0, 0x4d, 0xc8, 0x04, 0x67, 0x63, 0x5a, 0xd4, 0x76, 0x52, 0x77, 0x36, - 0xc3, 0x7d, 0xe1, 0x38, 0xe7, 0x6c, 0x4c, 0x09, 0x9f, 0x45, 0x95, 0x05, 0x41, 0xba, 0xb9, 0xd0, - 0xcc, 0x93, 0x22, 0x55, 0x87, 0xf5, 0xb8, 0x17, 0xe8, 0xb6, 0xb4, 0x9d, 0xe2, 0xb6, 0x51, 0x9c, - 0x8f, 0xfa, 0x31, 0xeb, 0x97, 0x20, 0xdb, 0xf1, 0xa6, 0xa3, 0x80, 0x07, 0x2f, 0x4b, 0xc4, 0xe0, - 0xf3, 0xc6, 0xfd, 0xf7, 0x29, 0xd8, 0x4c, 0xa6, 0x04, 0x7a, 0x1d, 0x0a, 0x22, 0x29, 0x58, 0x2c, - 0x53, 0x33, 0x47, 0x28, 0x8e, 0x94, 0x43, 0xea, 0x93, 0x48, 0x01, 0xbd, 0x04, 0xab, 0x9d, 0xc1, - 0x74, 0x12, 0x50, 0x9f, 0x1b, 0x8b, 0x16, 0x64, 0x0a, 0x29, 0x5f, 0x90, 0x82, 0x94, 0x2c, 0xc8, - 0x2b, 0x12, 0xf4, 0x7c, 0x22, 0x0e, 0x17, 0x13, 0x26, 0xcf, 0x0f, 0x84, 0xf1, 0x61, 0x0a, 0x20, - 0xaa, 0x8f, 0xe8, 0x2b, 0x50, 0x70, 0x63, 0x69, 0x13, 0x2f, 0x6c, 0x11, 0x6a, 0x2f, 0x4c, 0x20, - 0xb1, 0x4d, 0x91, 0x0a, 0xda, 0x81, 0x35, 0x77, 0x1a, 0x78, 0x8e, 0xdf, 0xef, 0xf5, 0xe4, 0x5a, - 0xf2, 0x24, 0x2e, 0x2a, 0xbd, 0x0e, 0x9b, 0x49, 0xf5, 0xa7, 0x0a, 0xfc, 0x21, 0xac, 0xc5, 0x2a, - 0x33, 0xba, 0x0c, 0x39, 0x51, 0x11, 0xa5, 0xb6, 0x1c, 0x9d, 0xef, 0x86, 0xf1, 0x71, 0x0a, 0xf4, - 0xd9, 0xf2, 0xba, 0x94, 0xae, 0x02, 0x05, 0x9f, 0x4e, 0xbc, 0xa9, 0xdf, 0xa1, 0xea, 0x9c, 0xdc, - 0x5e, 0x52, 0xa2, 0xf7, 0x88, 0x02, 0xca, 0xd8, 0x84, 0x8a, 0x6c, 0xe5, 0xc9, 0xc9, 0xa7, 0x5a, - 0xb9, 0x05, 0x1b, 0x89, 0x62, 0xfe, 0x39, 0xd6, 0xfe, 0x97, 0x0c, 0x64, 0x79, 0xe1, 0x44, 0x2f, - 0x43, 0x81, 0x95, 0x63, 0x3e, 0x90, 0xe5, 0x51, 0x8f, 0x95, 0x2f, 0x2e, 0xaf, 0xae, 0x90, 0x08, - 0x84, 0x5e, 0x95, 0x7d, 0x56, 0xa8, 0xa4, 0xe7, 0xfb, 0xac, 0xd2, 0x89, 0xc1, 0xd0, 0x17, 0x55, - 0xa7, 0x15, 0x5a, 0xda, 0x82, 0x4e, 0xab, 0xd4, 0xe2, 0x40, 0xe6, 0xde, 0x58, 0x15, 0xf9, 0x62, - 0x66, 0x71, 0xf1, 0x67, 0xee, 0x85, 0x20, 0x84, 0x13, 0x3d, 0x55, 0x28, 0x2e, 0xed, 0xa9, 0x4a, - 0x7f, 0x4e, 0x05, 0x7d, 0x1d, 0x8a, 0x6a, 0xdf, 0x66, 0xf1, 0xb2, 0xc1, 0xaa, 0x2a, 0x4f, 0x96, - 0xc0, 0xaa, 0x2b, 0x64, 0x29, 0x05, 0x7a, 0x3d, 0x6a, 0xda, 0x82, 0x73, 0x75, 0x61, 0xd3, 0x56, - 0x44, 0x49, 0x30, 0x7a, 0x1b, 0xae, 0x74, 0x17, 0x37, 0x65, 0xd9, 0x73, 0xcf, 0x69, 0xdd, 0xd5, - 0x15, 0xb2, 0x8c, 0x00, 0x7d, 0x09, 0xd6, 0xbb, 0xf4, 0xb4, 0xee, 0x79, 0x63, 0x41, 0x58, 0xe0, - 0x84, 0x51, 0x55, 0x89, 0xa6, 0xaa, 0x2b, 0x24, 0x01, 0x3d, 0x58, 0x07, 0xa0, 0xec, 0x47, 0x9b, - 0x55, 0x1b, 0x83, 0xc2, 0x7a, 0x1c, 0x8d, 0xae, 0x41, 0xa1, 0x1f, 0x50, 0x9f, 0xdf, 0x36, 0x65, - 0x3f, 0x8a, 0x04, 0xb1, 0x5c, 0x4e, 0x27, 0x72, 0xf9, 0x06, 0x68, 0xd4, 0xf7, 0x65, 0xc2, 0x6c, - 0x48, 0x2f, 0xb0, 0xef, 0x57, 0xe8, 0x09, 0x61, 0x33, 0x46, 0x03, 0x72, 0x62, 0x88, 0x5e, 0x84, - 0x55, 0xea, 0xfb, 0xa6, 0xd7, 0x55, 0xa5, 0x70, 0x2b, 0xb9, 0xe1, 0x5e, 0x97, 0x12, 0x85, 0x40, - 0x45, 0x58, 0x1d, 0xd2, 0xc9, 0xc4, 0xed, 0xa9, 0x83, 0xa6, 0x86, 0x86, 0x0d, 0x85, 0x30, 0xf3, - 0xd9, 0x69, 0xa4, 0xec, 0xa0, 0xca, 0x13, 0x26, 0x06, 0x89, 0x4b, 0x4e, 0xfa, 0x9c, 0x4b, 0x8e, - 0xf1, 0x6d, 0x59, 0x5e, 0x05, 0x61, 0x09, 0xf2, 0xaa, 0x56, 0x4a, 0xce, 0x70, 0xbc, 0x34, 0x06, - 0x7a, 0x14, 0x83, 0x02, 0x5f, 0x74, 0x7c, 0xa9, 0x99, 0xf3, 0x96, 0x6a, 0x74, 0x55, 0xc5, 0x14, - 0x1e, 0x2c, 0xab, 0x1a, 0xd2, 0x4a, 0x7a, 0xa1, 0x15, 0xed, 0x5c, 0x2b, 0xdf, 0x4d, 0x96, 0xd3, - 0x27, 0xdb, 0x5a, 0x1a, 0xfd, 0xcf, 0xbb, 0xd6, 0x8f, 0x52, 0x50, 0x5c, 0x76, 0x20, 0x59, 0xec, - 0xd5, 0x81, 0x54, 0xb1, 0x57, 0xe3, 0xa5, 0xb1, 0x8f, 0x79, 0xaa, 0x2d, 0xf4, 0x34, 0x13, 0x79, - 0x7a, 0x17, 0x60, 0x12, 0xfa, 0xc4, 0x8b, 0xce, 0x42, 0x67, 0x63, 0x20, 0xe3, 0xe7, 0x69, 0x28, - 0x84, 0x85, 0x8c, 0x1d, 0x91, 0x81, 0xd7, 0x71, 0x07, 0x4c, 0xa2, 0x8e, 0x48, 0x28, 0x40, 0xd7, - 0x01, 0x7c, 0x3a, 0xf4, 0x02, 0xca, 0xa7, 0x45, 0x0f, 0x8f, 0x49, 0x98, 0xab, 0x63, 0xaf, 0x6b, - 0xb3, 0x17, 0x92, 0x74, 0x55, 0x0e, 0xd1, 0x4d, 0xd8, 0xe8, 0xa8, 0x53, 0xce, 0xe7, 0x85, 0xd3, - 0x49, 0x21, 0xb3, 0xce, 0x9e, 0x54, 0x93, 0xb1, 0xdb, 0x11, 0xde, 0x17, 0x48, 0x24, 0x60, 0xc1, - 0x63, 0x45, 0x96, 0xab, 0xe7, 0x44, 0xf0, 0xd4, 0x18, 0x19, 0xb0, 0xae, 0x02, 0xc9, 0xae, 0x1b, - 0xbc, 0x98, 0x15, 0x48, 0x42, 0x16, 0xc7, 0x70, 0x8e, 0x7c, 0x12, 0xc3, 0x79, 0x8a, 0xb0, 0xea, - 0x76, 0xbb, 0x3e, 0x9d, 0x4c, 0x78, 0xd9, 0x29, 0x10, 0x35, 0x34, 0x3e, 0x48, 0x45, 0xcd, 0x2f, - 0x8c, 0x15, 0x2b, 0x8a, 0x26, 0xbf, 0xd0, 0xc8, 0x58, 0x85, 0x02, 0x76, 0x6e, 0xfb, 0xc3, 0x28, - 0xbd, 0xc4, 0x20, 0xb6, 0xc9, 0xda, 0xa2, 0xd4, 0xcf, 0x2c, 0x4c, 0xba, 0xec, 0xb9, 0x49, 0xf7, - 0x69, 0x1a, 0xae, 0x2c, 0xa9, 0xb4, 0x4f, 0x3a, 0x01, 0x6a, 0xb3, 0xd2, 0xe7, 0x6c, 0x96, 0x76, - 0xee, 0x66, 0x65, 0x16, 0x6c, 0x56, 0x58, 0x65, 0xb2, 0x33, 0x55, 0xa6, 0x08, 0xab, 0xfe, 0x74, - 0xc4, 0x9e, 0xf5, 0x72, 0x1f, 0xd5, 0x90, 0x25, 0xd8, 0xbb, 0x9e, 0xff, 0xb8, 0x3f, 0xea, 0x55, - 0xfa, 0xbe, 0xdc, 0xc4, 0x98, 0x04, 0xd9, 0x00, 0xbc, 0x6b, 0x88, 0x47, 0x6f, 0x9e, 0xdf, 0x82, - 0xf6, 0x9e, 0xdc, 0x69, 0x84, 0x3c, 0xf6, 0x04, 0x8e, 0x31, 0xb0, 0x2b, 0xf8, 0xcc, 0xf4, 0x79, - 0xf7, 0xa1, 0x8d, 0xf8, 0x7d, 0xe8, 0x5b, 0x90, 0xaf, 0x7b, 0x3d, 0xa1, 0xf7, 0x1a, 0x14, 0xc2, - 0x0f, 0x15, 0xf2, 0x1a, 0x53, 0xda, 0x13, 0x5f, 0x2a, 0xf6, 0xd4, 0x97, 0x8a, 0x3d, 0x47, 0x21, - 0x48, 0x04, 0x46, 0x06, 0x64, 0x69, 0xec, 0x26, 0xa3, 0xbe, 0x50, 0xc8, 0x67, 0x25, 0x4d, 0x76, - 0x01, 0x2d, 0xd6, 0x05, 0x8c, 0x7b, 0xb0, 0xd5, 0x9a, 0x50, 0xdf, 0x1a, 0x05, 0x0c, 0x2a, 0xbf, - 0x51, 0xdc, 0x82, 0x5c, 0x9f, 0x0b, 0xa4, 0x17, 0xaa, 0x65, 0x49, 0x94, 0x9c, 0x34, 0xbe, 0x0c, - 0x9b, 0xf2, 0x2e, 0xa6, 0x14, 0x5f, 0x48, 0x7e, 0x29, 0x51, 0x0d, 0x57, 0xa2, 0x12, 0x1f, 0x4c, - 0xee, 0xc2, 0x7a, 0x5c, 0x8c, 0x4a, 0xb0, 0x4a, 0x47, 0xee, 0xa3, 0x01, 0x15, 0x0f, 0xdc, 0x7c, - 0x75, 0x85, 0x28, 0xc1, 0x41, 0x16, 0xb4, 0x53, 0x77, 0x60, 0x3c, 0x80, 0x9c, 0xf0, 0x80, 0xad, - 0x25, 0x7a, 0x0b, 0xe7, 0xd5, 0xab, 0x17, 0x41, 0x66, 0x72, 0x36, 0xea, 0xc8, 0xbb, 0x22, 0xff, - 0xcd, 0x52, 0x57, 0xbe, 0x84, 0x35, 0x2e, 0x95, 0xa3, 0x5d, 0x0f, 0xd6, 0x62, 0x8f, 0x2c, 0x54, - 0x84, 0x4b, 0x2d, 0xbb, 0x66, 0x37, 0xde, 0xb2, 0xdb, 0x07, 0x2d, 0xab, 0x5e, 0xc1, 0xa4, 0xed, - 0x3c, 0x3c, 0xc6, 0xfa, 0x0a, 0x5a, 0x05, 0xed, 0x81, 0x75, 0xa0, 0xa7, 0x50, 0x01, 0xb2, 0x07, - 0xe5, 0xb7, 0x71, 0x5d, 0x4f, 0xa3, 0x4d, 0x00, 0x8e, 0x3a, 0x2e, 0x9b, 0xb5, 0xa6, 0xae, 0x21, - 0x80, 0x9c, 0xd9, 0x6a, 0x3a, 0x8d, 0x23, 0x3d, 0xc3, 0x7e, 0xd7, 0xca, 0xb6, 0x55, 0x6b, 0xe8, - 0x59, 0xf6, 0xbb, 0xd2, 0x30, 0x6b, 0x98, 0xe8, 0xb9, 0xdd, 0x0a, 0x14, 0xc2, 0x17, 0x25, 0xba, - 0x0c, 0x28, 0x61, 0x4e, 0x19, 0x5b, 0x83, 0x55, 0xb3, 0xde, 0x6a, 0x3a, 0x98, 0xe8, 0x29, 0x66, - 0xf9, 0xd0, 0x3c, 0xd0, 0xd3, 0xcc, 0x72, 0xbd, 0x61, 0x96, 0xeb, 0xba, 0xb6, 0xdb, 0x60, 0xf7, - 0x91, 0xe8, 0x4d, 0x84, 0x9e, 0x81, 0x6d, 0x45, 0x54, 0xc1, 0xc7, 0xf5, 0xc6, 0xc3, 0xc8, 0xf1, - 0x3c, 0x64, 0xaa, 0xb8, 0x7e, 0xa4, 0xa7, 0xd0, 0x06, 0x14, 0x6a, 0xdc, 0x3d, 0xeb, 0x6d, 0xac, - 0xa7, 0x99, 0x91, 0x5a, 0xeb, 0x00, 0x9b, 0x0e, 0x23, 0xb4, 0x60, 0x2d, 0xf6, 0x36, 0x8b, 0xc7, - 0x41, 0x3a, 0xa2, 0xe8, 0xd6, 0x21, 0x7f, 0x64, 0xd9, 0x16, 0xd3, 0x94, 0xbe, 0xd5, 0xb0, 0xf0, - 0xad, 0xe1, 0x54, 0x31, 0xd1, 0xb5, 0xdd, 0x9f, 0x15, 0x00, 0xa2, 0xca, 0x82, 0x72, 0x90, 0x6e, - 0xd4, 0xf4, 0x15, 0x54, 0x84, 0x8b, 0x4d, 0xa7, 0xec, 0xb4, 0x9a, 0x66, 0x15, 0x9b, 0xb5, 0x76, - 0xb3, 0x65, 0x9a, 0xb8, 0xd9, 0xd4, 0xff, 0x90, 0x42, 0x08, 0x36, 0xc4, 0xea, 0x95, 0xec, 0x8f, - 0x29, 0x74, 0x0d, 0x8a, 0x42, 0x76, 0xdc, 0x6a, 0x56, 0xdb, 0x65, 0x2e, 0x6f, 0x57, 0xb0, 0x6d, - 0xe1, 0x8a, 0x4e, 0xd1, 0x55, 0xb8, 0x22, 0x67, 0x49, 0xe3, 0x01, 0x36, 0x9d, 0xb6, 0xdd, 0x70, - 0xda, 0xf7, 0x1b, 0x2d, 0xbb, 0xa2, 0x9f, 0xa0, 0x1b, 0x50, 0x8a, 0x1b, 0xb2, 0x8e, 0xca, 0x87, - 0xb8, 0x7d, 0xdc, 0xaa, 0xd7, 0xdb, 0x98, 0x10, 0xfd, 0xc3, 0x34, 0xfa, 0x3f, 0xb8, 0x1e, 0x07, - 0x98, 0x0d, 0xdb, 0x29, 0x5b, 0x36, 0x26, 0x6d, 0x93, 0xe0, 0xb2, 0x63, 0xd9, 0x87, 0xfa, 0x47, - 0x69, 0x64, 0xc0, 0xb3, 0x71, 0x10, 0x69, 0xd9, 0x31, 0x20, 0x23, 0xfa, 0x38, 0x8d, 0x6e, 0xc1, - 0xce, 0x62, 0x22, 0x07, 0x93, 0x23, 0xcb, 0x2e, 0x3b, 0xb8, 0xa2, 0xff, 0x22, 0x8d, 0x5e, 0x84, - 0xdb, 0x71, 0x98, 0xd8, 0xa0, 0x23, 0x6c, 0x3b, 0x6d, 0xd2, 0xa8, 0xd7, 0x1b, 0x2d, 0xa7, 0x7d, - 0x8c, 0xed, 0x0a, 0xb3, 0xfb, 0xcb, 0x27, 0x70, 0x12, 0xdc, 0x74, 0xca, 0x84, 0xbb, 0xf7, 0xc9, - 0x1c, 0xcc, 0x6e, 0x54, 0x70, 0xfb, 0x08, 0x1f, 0x35, 0xc8, 0xc3, 0xf6, 0x31, 0xc1, 0xcd, 0x66, - 0x8b, 0x60, 0xfd, 0x7b, 0xda, 0xec, 0x52, 0x39, 0xac, 0x62, 0x35, 0x6b, 0x11, 0xe8, 0xfb, 0x1a, - 0x7a, 0x01, 0x6e, 0xce, 0x81, 0x6c, 0xec, 0xbc, 0xd5, 0x20, 0xb5, 0x76, 0xcb, 0x2e, 0xbf, 0x59, - 0xb6, 0xea, 0xe5, 0x83, 0x3a, 0xd6, 0x7f, 0xa0, 0xcd, 0x46, 0x85, 0x43, 0x8f, 0xad, 0x4a, 0x44, - 0xf7, 0xde, 0x62, 0x9b, 0x2d, 0x9b, 0x8d, 0x2a, 0x2d, 0x41, 0xf4, 0x43, 0x0d, 0x3d, 0x07, 0xd7, - 0x16, 0x80, 0x08, 0x2e, 0x9b, 0x55, 0x0e, 0x79, 0x5f, 0x9b, 0xdd, 0x47, 0xe1, 0x56, 0xc3, 0x69, - 0x13, 0x5c, 0xae, 0x3c, 0xd4, 0x7f, 0x34, 0xe7, 0xcc, 0xfd, 0xb2, 0x55, 0xc7, 0x95, 0xb6, 0x34, - 0xc4, 0xe2, 0xf4, 0x63, 0x0d, 0x95, 0x60, 0x3b, 0x8e, 0x69, 0xd9, 0x55, 0x5c, 0xae, 0x3b, 0xd5, - 0x87, 0xfa, 0x4f, 0x34, 0xf4, 0x3c, 0x18, 0xf1, 0x39, 0x79, 0x18, 0x58, 0xc8, 0x6d, 0x6c, 0x3a, - 0x56, 0xc3, 0xe6, 0xfb, 0xfc, 0xd3, 0xb9, 0x15, 0x29, 0x20, 0x5b, 0x78, 0xcd, 0xaa, 0xd7, 0x71, - 0x45, 0xff, 0x40, 0x63, 0x59, 0xac, 0x8e, 0x0c, 0x26, 0xa4, 0x41, 0xf4, 0x4f, 0xb5, 0xd9, 0x9c, - 0x97, 0xf3, 0xfa, 0x67, 0x1a, 0xba, 0x0d, 0xcf, 0x2d, 0x98, 0x99, 0x89, 0xd3, 0xdf, 0x34, 0xb4, - 0x0b, 0xb7, 0x16, 0xa7, 0xc3, 0x5b, 0x65, 0x8b, 0xe5, 0x42, 0xc8, 0xf9, 0x77, 0x0d, 0x5d, 0x87, - 0x67, 0x16, 0x71, 0xe2, 0x37, 0xb1, 0xed, 0xe8, 0xff, 0xd5, 0xd0, 0x45, 0xd8, 0x14, 0xb9, 0x17, - 0x2a, 0xfd, 0x43, 0x43, 0x5b, 0xb0, 0xde, 0x7c, 0x68, 0x9b, 0xa1, 0xe8, 0x9f, 0x5a, 0x74, 0x1e, - 0x95, 0xec, 0x5f, 0x1a, 0xba, 0x04, 0x17, 0x2a, 0xf8, 0x4d, 0xcb, 0xb6, 0x9c, 0x50, 0xfa, 0x6f, - 0x2e, 0x35, 0xeb, 0xb8, 0x6c, 0xb7, 0x8e, 0x43, 0xe9, 0x7f, 0xb8, 0x94, 0x53, 0x72, 0xb4, 0x88, - 0xc5, 0x9f, 0x33, 0x68, 0x07, 0xae, 0x2a, 0x06, 0x82, 0x0f, 0x2d, 0x5e, 0x53, 0x84, 0x99, 0x0a, - 0x3e, 0x6e, 0xea, 0xbf, 0xce, 0xb2, 0x0d, 0x9f, 0x43, 0x38, 0xb8, 0xe9, 0x08, 0xc0, 0x6f, 0xb2, - 0x2c, 0x69, 0xe6, 0x00, 0x72, 0x45, 0x1c, 0xf2, 0xdb, 0xec, 0x42, 0x2b, 0x66, 0xc3, 0xbe, 0x6f, - 0x1d, 0x32, 0x88, 0xfe, 0xbb, 0xec, 0x2b, 0xbf, 0xca, 0xc2, 0x85, 0xa6, 0xfc, 0x67, 0x42, 0x93, - 0xfa, 0xa7, 0xfd, 0x0e, 0x45, 0x26, 0xe4, 0x0f, 0x69, 0x20, 0x3f, 0x44, 0xcc, 0xb5, 0x5a, 0x3c, - 0x1c, 0x07, 0x67, 0xa5, 0xc4, 0xe7, 0x7e, 0x63, 0xeb, 0x3b, 0x7f, 0xfa, 0xe4, 0xbd, 0xf4, 0x1a, - 0x2a, 0xec, 0x9f, 0xde, 0xdd, 0xe7, 0x9d, 0x0c, 0x1d, 0x42, 0x9e, 0x37, 0xda, 0xba, 0xd7, 0x43, - 0xea, 0x09, 0xa5, 0x7a, 0x7a, 0x69, 0x56, 0x60, 0x6c, 0x73, 0x82, 0x0b, 0x68, 0x83, 0x11, 0x88, - 0x97, 0xe6, 0xc0, 0xeb, 0xdd, 0x49, 0xbd, 0x9c, 0x42, 0x87, 0x90, 0xe3, 0x44, 0x93, 0xa5, 0xbe, - 0xcc, 0xb1, 0x21, 0xce, 0xb6, 0x8e, 0x20, 0x64, 0x9b, 0xbc, 0x9c, 0x42, 0x5f, 0x83, 0x55, 0xfc, - 0x4d, 0xda, 0x99, 0x06, 0x14, 0x15, 0xa5, 0xc6, 0x5c, 0x93, 0x2f, 0x2d, 0xb1, 0x61, 0x5c, 0xe5, - 0x94, 0xdb, 0xc6, 0x1a, 0xa7, 0x14, 0x34, 0xf7, 0x64, 0xcb, 0x47, 0x2e, 0x14, 0xca, 0xd3, 0xc0, - 0xe3, 0x9d, 0x0c, 0x6d, 0x27, 0xdb, 0xfb, 0x79, 0xc4, 0xb7, 0x38, 0xf1, 0x8d, 0xd2, 0x65, 0x46, - 0xcc, 0x3b, 0xf6, 0xbe, 0x3b, 0x0d, 0xbc, 0xb6, 0xb2, 0x21, 0x2e, 0x06, 0xa8, 0x0d, 0x79, 0x66, - 0x82, 0x5d, 0x92, 0x9f, 0xd6, 0xc2, 0x4d, 0x6e, 0xe1, 0x7a, 0x69, 0x9b, 0x6f, 0xce, 0xd9, 0xa8, - 0xb3, 0xd0, 0x40, 0x07, 0x80, 0x19, 0x10, 0x7d, 0xf4, 0x69, 0x4d, 0xdc, 0xe6, 0x26, 0x76, 0x4a, - 0x57, 0x98, 0x09, 0x71, 0x97, 0x58, 0x68, 0xa4, 0x0e, 0xb9, 0xaa, 0x3b, 0xea, 0x0e, 0x28, 0x4a, - 0x5c, 0xc6, 0x96, 0xf2, 0x5e, 0xe3, 0xbc, 0x97, 0x8d, 0xad, 0x68, 0x23, 0xf7, 0xdf, 0xe1, 0x04, - 0xf7, 0x52, 0xbb, 0x8f, 0x72, 0x1c, 0xfd, 0xea, 0xff, 0x02, 0x00, 0x00, 0xff, 0xff, 0xf5, 0x03, - 0x8a, 0x2e, 0x0e, 0x1b, 0x00, 0x00, + // 2600 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xc4, 0x59, 0x4d, 0x90, 0x1b, 0x47, + 0x15, 0x5e, 0x69, 0xa4, 0x5d, 0xe9, 0xed, 0x8f, 0xc7, 0x6d, 0xaf, 0xad, 0xc8, 0x8e, 0xbd, 0x19, + 0xec, 0x8d, 0xb3, 0x09, 0xbb, 0x71, 0x4c, 0x51, 0xc1, 0x24, 0x50, 0xda, 0xd1, 0x78, 0x35, 0x5e, + 0xed, 0x68, 0xab, 0x35, 0x4a, 0x70, 0xaa, 0x28, 0xd5, 0x58, 0xea, 0x55, 0x54, 0xd6, 0x6a, 0xc4, + 0xcc, 0xc8, 0x61, 0x2f, 0x1c, 0xb8, 0x72, 0x01, 0x42, 0xf8, 0x2b, 0x0e, 0x5c, 0xb8, 0x85, 0xc0, + 0x95, 0xa2, 0x20, 0xdc, 0x80, 0x33, 0x55, 0x54, 0x71, 0xa4, 0x2a, 0x1c, 0xb8, 0x27, 0xfc, 0x53, + 0x45, 0xf5, 0xdf, 0x4c, 0x8f, 0x7e, 0xbc, 0xd9, 0xca, 0x81, 0xd3, 0xaa, 0x5f, 0x7f, 0xef, 0xb7, + 0x5f, 0xbf, 0xf7, 0xa6, 0x17, 0xd6, 0xc2, 0x47, 0xde, 0xd1, 0x91, 0x3f, 0xe8, 0x6e, 0x8f, 0x02, + 0x3f, 0xf2, 0x51, 0x9e, 0xfd, 0x29, 0x5f, 0xed, 0xf9, 0x7e, 0x6f, 0x40, 0x76, 0xbc, 0x51, 0x7f, + 0xc7, 0x1b, 0x0e, 0xfd, 0xc8, 0x8b, 0xfa, 0xfe, 0x30, 0xe4, 0xa0, 0xf2, 0x75, 0xb1, 0xcb, 0x56, + 0x0f, 0xc7, 0x47, 0x3b, 0x51, 0xff, 0x98, 0x84, 0x91, 0x77, 0x3c, 0x12, 0x80, 0x2b, 0x93, 0x00, + 0x72, 0x3c, 0x8a, 0x4e, 0xf8, 0xa6, 0x71, 0x07, 0x56, 0x9b, 0x91, 0x17, 0x11, 0x4c, 0xc2, 0x91, + 0x3f, 0x0c, 0x09, 0x32, 0x20, 0x1f, 0x52, 0x42, 0x29, 0xb3, 0x91, 0xb9, 0xb5, 0xfc, 0xd2, 0x0a, + 0xc7, 0x6d, 0x73, 0x10, 0xdf, 0x32, 0xae, 0x42, 0x21, 0xc6, 0xeb, 0xa0, 0x1d, 0x87, 0x3d, 0x86, + 0x2e, 0x62, 0xfa, 0xd3, 0x78, 0x1a, 0x96, 0x30, 0xf9, 0xca, 0x98, 0x84, 0x11, 0x42, 0x90, 0x1b, + 0x7a, 0xc7, 0x44, 0xec, 0xb2, 0xdf, 0xc6, 0x3b, 0x39, 0xc8, 0x33, 0x69, 0xe8, 0x36, 0xc0, 0xc3, + 0x71, 0x7f, 0xd0, 0x6d, 0x2a, 0xfa, 0xce, 0x0b, 0x7d, 0xbb, 0xf1, 0x06, 0x56, 0x40, 0xe8, 0x33, + 0xb0, 0xdc, 0x25, 0xa3, 0x81, 0x7f, 0xc2, 0x79, 0xb2, 0x8c, 0x07, 0x09, 0x9e, 0x6a, 0xb2, 0x83, + 0x55, 0x18, 0xaa, 0xc1, 0xda, 0x91, 0x1f, 0xbc, 0xe5, 0x05, 0x5d, 0xd2, 0x3d, 0xf4, 0x83, 0x28, + 0x2c, 0xe5, 0x36, 0xb4, 0x5b, 0xcb, 0x2f, 0x6d, 0xa8, 0xce, 0x6d, 0xdf, 0x4b, 0x41, 0xac, 0x61, + 0x14, 0x9c, 0xe0, 0x09, 0x3e, 0x64, 0x82, 0x4e, 0x43, 0x30, 0x0e, 0xcd, 0x37, 0x49, 0xe7, 0x11, + 0x37, 0x22, 0xcf, 0x8c, 0xb8, 0xac, 0xc8, 0x52, 0xb7, 0xf1, 0x14, 0x03, 0xba, 0x0b, 0xab, 0x47, + 0xfd, 0x01, 0x69, 0x9e, 0x0c, 0x3b, 0x5c, 0xc2, 0x22, 0x93, 0x70, 0x51, 0x48, 0xb8, 0xa7, 0xee, + 0xe1, 0x34, 0x14, 0x1d, 0xc2, 0x85, 0x2e, 0x79, 0x38, 0xee, 0xf5, 0xfa, 0xc3, 0x9e, 0xe9, 0x0f, + 0x23, 0xaf, 0x3f, 0x24, 0x41, 0x58, 0x5a, 0x62, 0xfe, 0x5c, 0x8b, 0x03, 0x31, 0x89, 0xb0, 0x1e, + 0x93, 0x61, 0x84, 0x67, 0xb1, 0xa2, 0xe7, 0xa1, 0x70, 0x4c, 0x22, 0xaf, 0xeb, 0x45, 0x5e, 0xa9, + 0xc0, 0x0c, 0x39, 0x27, 0xc4, 0x1c, 0x08, 0x32, 0x8e, 0x01, 0xe5, 0x26, 0x5c, 0x98, 0x11, 0x26, + 0x9a, 0x04, 0x8f, 0xc8, 0x09, 0x3b, 0xc2, 0x3c, 0xa6, 0x3f, 0xd1, 0x26, 0xe4, 0x1f, 0x7b, 0x83, + 0xb1, 0x3c, 0x22, 0x5d, 0x88, 0xa4, 0x3c, 0xdc, 0x16, 0xbe, 0x7d, 0x37, 0xfb, 0x72, 0xe6, 0x7e, + 0xae, 0xa0, 0xe9, 0x39, 0xe3, 0x2f, 0x19, 0x28, 0x48, 0x8d, 0x68, 0x0b, 0xf2, 0xec, 0xd4, 0x45, + 0x56, 0x5c, 0x54, 0xb3, 0x22, 0x36, 0x8b, 0x43, 0xd0, 0xa7, 0x61, 0x91, 0x1f, 0xb6, 0xd0, 0xb5, + 0x9e, 0x4a, 0x87, 0x18, 0x2d, 0x40, 0xe8, 0x8b, 0x00, 0x5e, 0xb7, 0xdb, 0xa7, 0x57, 0xc8, 0x1b, + 0x94, 0x3a, 0x2c, 0x70, 0xd7, 0x27, 0x3c, 0xde, 0xae, 0xc4, 0x08, 0x9e, 0x07, 0x0a, 0x4b, 0xf9, + 0x55, 0x38, 0x37, 0xb1, 0xad, 0xfa, 0x5f, 0xe4, 0xfe, 0x5f, 0x54, 0xfd, 0x2f, 0x2a, 0xde, 0x1a, + 0x1f, 0x65, 0x61, 0x35, 0xe5, 0x07, 0x7a, 0x01, 0xce, 0x0f, 0xc7, 0xc7, 0x0f, 0x49, 0xd0, 0x38, + 0xaa, 0x04, 0x51, 0xff, 0xc8, 0xeb, 0x44, 0xa1, 0x88, 0xe5, 0xf4, 0x06, 0x7a, 0x15, 0x0a, 0xcc, + 0x6f, 0x7a, 0xec, 0x59, 0x66, 0xfd, 0x33, 0xb3, 0xa2, 0xb3, 0x6d, 0x1f, 0x7b, 0x3d, 0xb2, 0xcb, + 0x91, 0x38, 0x66, 0x41, 0x37, 0x20, 0x17, 0x9d, 0x8c, 0x48, 0x49, 0xdb, 0xc8, 0xdc, 0x5a, 0x8b, + 0xcf, 0x85, 0xe1, 0xdc, 0x93, 0x11, 0xc1, 0x6c, 0x17, 0x55, 0x67, 0x04, 0xe9, 0xc6, 0x4c, 0x35, + 0x4f, 0x8a, 0x54, 0x1d, 0x56, 0x54, 0x2b, 0xd0, 0xa6, 0xd0, 0x9d, 0x61, 0xba, 0x91, 0x2a, 0x8f, + 0x04, 0x8a, 0xf6, 0x8b, 0x90, 0xef, 0xf8, 0xe3, 0x61, 0xc4, 0x82, 0x97, 0xc7, 0x7c, 0xf1, 0x49, + 0xe3, 0xfe, 0xdb, 0x0c, 0xac, 0xa5, 0x53, 0x02, 0xbd, 0x02, 0x45, 0x9e, 0x14, 0x34, 0x96, 0x99, + 0x89, 0x2b, 0xa4, 0x22, 0xc5, 0x92, 0x04, 0x38, 0x61, 0x40, 0x2f, 0xc0, 0x52, 0x67, 0x30, 0x0e, + 0x23, 0x12, 0x30, 0x65, 0x89, 0x43, 0x26, 0xa7, 0x32, 0x87, 0x24, 0xa4, 0x6c, 0x43, 0x41, 0x0a, + 0x41, 0xcf, 0xa6, 0xe2, 0x70, 0x21, 0xa5, 0xf2, 0xf4, 0x40, 0x18, 0xef, 0x66, 0x00, 0x92, 0xfa, + 0x88, 0xbe, 0x00, 0x45, 0x4f, 0x49, 0x1b, 0xb5, 0xb0, 0x25, 0xa8, 0xed, 0x38, 0x81, 0xf8, 0x31, + 0x25, 0x2c, 0x68, 0x03, 0x96, 0xbd, 0x71, 0xe4, 0xbb, 0x41, 0xbf, 0xd7, 0x13, 0xbe, 0x14, 0xb0, + 0x4a, 0x2a, 0xbf, 0x02, 0x6b, 0x69, 0xf6, 0x33, 0x05, 0x7e, 0x0f, 0x96, 0x95, 0xca, 0x8c, 0x2e, + 0xc1, 0x22, 0xaf, 0x88, 0x82, 0x5b, 0xac, 0x4e, 0x37, 0xc3, 0x78, 0x2f, 0x03, 0xfa, 0x64, 0x79, + 0x9d, 0x2b, 0xae, 0x0a, 0xc5, 0x80, 0x84, 0xfe, 0x38, 0xe8, 0x10, 0x79, 0x4f, 0x36, 0xe7, 0x94, + 0xe8, 0x6d, 0x2c, 0x81, 0x22, 0x36, 0x31, 0x23, 0xf5, 0x3c, 0xbd, 0x79, 0x26, 0xcf, 0x6d, 0x58, + 0x4d, 0x15, 0xf3, 0x4f, 0xe0, 0xfb, 0x9f, 0x73, 0x90, 0x67, 0x85, 0x13, 0xbd, 0x08, 0x45, 0x5a, + 0x8e, 0xd9, 0x42, 0x94, 0x47, 0x5d, 0x29, 0x5f, 0x8c, 0x5e, 0x5b, 0xc0, 0x09, 0x08, 0xdd, 0x11, + 0x7d, 0x96, 0xb3, 0x64, 0xa7, 0xfb, 0xac, 0xe4, 0x51, 0x60, 0xe8, 0xb3, 0xb2, 0xd3, 0x72, 0x2e, + 0x6d, 0x46, 0xa7, 0x95, 0x6c, 0x2a, 0x90, 0x9a, 0x37, 0x92, 0x45, 0xbe, 0x94, 0x9b, 0x5d, 0xfc, + 0xa9, 0x79, 0x31, 0x08, 0x59, 0xa9, 0x9e, 0xca, 0x19, 0xe7, 0xf6, 0x54, 0xc9, 0x3f, 0xc5, 0x82, + 0xbe, 0x0c, 0x25, 0x79, 0x6e, 0x93, 0x78, 0xd1, 0x60, 0x65, 0x95, 0xc7, 0x73, 0x60, 0xb5, 0x05, + 0x3c, 0x57, 0x04, 0x7a, 0x25, 0x69, 0xda, 0x5c, 0xe6, 0xd2, 0xcc, 0xa6, 0x2d, 0x05, 0xa5, 0xc1, + 0xe8, 0x0d, 0xb8, 0xdc, 0x9d, 0xdd, 0x94, 0x45, 0xcf, 0x3d, 0xa5, 0x75, 0xd7, 0x16, 0xf0, 0x3c, + 0x01, 0xe8, 0x73, 0xb0, 0xd2, 0x25, 0x8f, 0xeb, 0xbe, 0x3f, 0xe2, 0x02, 0x8b, 0x4c, 0x60, 0x52, + 0x55, 0x92, 0xad, 0xda, 0x02, 0x4e, 0x41, 0x77, 0x57, 0x00, 0x08, 0xfd, 0xd1, 0xa6, 0xd5, 0xc6, + 0x18, 0xc0, 0x8a, 0x8a, 0x46, 0x57, 0xa1, 0xd8, 0x8f, 0x48, 0xc0, 0xa6, 0x4d, 0xd1, 0x8f, 0x12, + 0x82, 0x92, 0xcb, 0xd9, 0x54, 0x2e, 0x6f, 0x82, 0x46, 0x82, 0x40, 0x24, 0x8c, 0x0c, 0x4f, 0xa5, + 0xc3, 0xca, 0xf6, 0xc3, 0x01, 0xb1, 0x82, 0x00, 0x53, 0x80, 0xf1, 0x8d, 0x0c, 0xac, 0xa6, 0xc8, + 0xe8, 0x79, 0x58, 0x22, 0x41, 0x60, 0xfa, 0x5d, 0x59, 0x19, 0xcf, 0xa7, 0xcf, 0xdf, 0xef, 0x12, + 0x2c, 0x11, 0xa8, 0x04, 0x4b, 0xc7, 0x24, 0x0c, 0xbd, 0x9e, 0xbc, 0x77, 0x72, 0x89, 0xee, 0xc0, + 0x72, 0x38, 0xee, 0xf5, 0x48, 0xc8, 0xa6, 0xe4, 0x92, 0xc6, 0xee, 0x7e, 0x2c, 0x2a, 0xde, 0xc1, + 0x2a, 0xca, 0x70, 0xa0, 0x18, 0xdf, 0x1e, 0x7a, 0xa3, 0x09, 0xbd, 0xec, 0xe2, 0x96, 0xf2, 0x45, + 0x6a, 0x50, 0xca, 0x9e, 0x32, 0x28, 0x19, 0xbf, 0x94, 0x35, 0x9a, 0x4b, 0x2c, 0x43, 0x41, 0x16, + 0x5c, 0x21, 0x34, 0x5e, 0xcf, 0x0d, 0xa4, 0x9e, 0x04, 0xb2, 0xc8, 0x42, 0xa6, 0x06, 0x28, 0x77, + 0x6a, 0x80, 0xee, 0xc2, 0xaa, 0xa7, 0x86, 0x57, 0xdc, 0xa9, 0xd9, 0x27, 0x92, 0x86, 0x1a, 0x3f, + 0xce, 0xc8, 0x9a, 0xcd, 0xcd, 0x9f, 0x57, 0xb7, 0x84, 0x89, 0xd9, 0x99, 0x26, 0x6a, 0x67, 0x37, + 0x31, 0xf7, 0xf1, 0x4d, 0x7c, 0x3f, 0xdd, 0x0c, 0x9e, 0x6c, 0xe7, 0xfc, 0x64, 0xf9, 0x3f, 0x06, + 0xf9, 0xaf, 0x19, 0x28, 0xcd, 0x2b, 0x45, 0x34, 0x61, 0x64, 0x29, 0x92, 0x09, 0x23, 0xd7, 0x73, + 0x13, 0x46, 0xf1, 0x52, 0x9b, 0xe9, 0x65, 0x2e, 0xf1, 0xf2, 0x36, 0x40, 0x18, 0xfb, 0xc3, 0xac, + 0x9e, 0xe9, 0xa8, 0x02, 0x9a, 0xf6, 0x75, 0xf1, 0xe3, 0xfb, 0xfa, 0x93, 0x2c, 0x14, 0xe3, 0xf2, + 0x4f, 0x0b, 0xcb, 0xc0, 0xef, 0x78, 0x03, 0x4a, 0x91, 0x85, 0x25, 0x26, 0xa0, 0x6b, 0x00, 0x01, + 0x39, 0xf6, 0x23, 0xc2, 0xb6, 0xf9, 0xe4, 0xa3, 0x50, 0xa8, 0x9b, 0x23, 0xbf, 0xeb, 0xd0, 0xef, + 0x4a, 0xe1, 0xa6, 0x58, 0xa2, 0x1b, 0xb0, 0xda, 0x91, 0xb5, 0x91, 0xed, 0x73, 0x87, 0xd3, 0x44, + 0xaa, 0x9d, 0x7e, 0x88, 0x86, 0x23, 0xaf, 0xc3, 0x3d, 0x2f, 0xe2, 0x84, 0x40, 0x03, 0x4f, 0x5b, + 0x13, 0x63, 0x5f, 0xe4, 0x81, 0x97, 0x6b, 0x64, 0xc0, 0x8a, 0x3c, 0x04, 0x3a, 0xa4, 0xb1, 0x16, + 0x50, 0xc4, 0x29, 0x9a, 0x8a, 0x61, 0x32, 0x0a, 0x69, 0x0c, 0x93, 0x53, 0x82, 0x25, 0xaf, 0xdb, + 0x0d, 0x48, 0x18, 0xb2, 0x62, 0x5d, 0xc4, 0x72, 0x69, 0xfc, 0x31, 0x93, 0x8c, 0x0c, 0x71, 0xac, + 0x68, 0x2b, 0x31, 0xd9, 0x18, 0x28, 0x62, 0x15, 0x13, 0x68, 0xa5, 0xea, 0x1f, 0x27, 0x69, 0xcd, + 0x17, 0x4a, 0x82, 0x68, 0xb3, 0xae, 0x6b, 0x6e, 0x66, 0xb2, 0xe7, 0xcf, 0x9e, 0xec, 0x67, 0x48, + 0x80, 0x0f, 0xb3, 0x70, 0x79, 0x4e, 0x6f, 0x7b, 0xd2, 0xad, 0x95, 0x07, 0x9d, 0x3d, 0xe5, 0xa0, + 0xb5, 0x53, 0x0f, 0x3a, 0x37, 0xe3, 0xa0, 0xe3, 0x92, 0x9c, 0x9f, 0x28, 0xc9, 0x25, 0x58, 0x0a, + 0xc6, 0xc3, 0xa8, 0x1f, 0xe7, 0x80, 0x5c, 0xd2, 0xe4, 0x7c, 0xcb, 0x0f, 0x1e, 0xf5, 0x87, 0xbd, + 0x6a, 0x3f, 0x10, 0x09, 0xa0, 0x50, 0x90, 0x03, 0xc0, 0xfa, 0x34, 0x7f, 0x66, 0x28, 0xb0, 0xde, + 0xb3, 0xfd, 0xe4, 0xde, 0xce, 0xe9, 0xca, 0xa3, 0x83, 0x22, 0x81, 0x7e, 0xf4, 0x4c, 0x6c, 0x9f, + 0x36, 0x81, 0xae, 0xaa, 0x13, 0xe8, 0xd7, 0xa0, 0x50, 0xf7, 0x7b, 0x9c, 0xef, 0x65, 0x28, 0xc6, + 0x4f, 0x43, 0x62, 0x70, 0x2c, 0x6f, 0xf3, 0xb7, 0xa1, 0x6d, 0xf9, 0x36, 0xb4, 0xed, 0x4a, 0x04, + 0x4e, 0xc0, 0xc8, 0x80, 0x3c, 0x51, 0x66, 0x47, 0xf9, 0x26, 0x24, 0x3e, 0xe4, 0x49, 0xba, 0x67, + 0x6a, 0x4a, 0xcf, 0x34, 0xee, 0xc2, 0xf9, 0x56, 0x48, 0x02, 0x7b, 0x18, 0x51, 0xa8, 0x78, 0x15, + 0xba, 0x09, 0x8b, 0x7d, 0x46, 0x10, 0x56, 0xac, 0x0a, 0x79, 0x02, 0x25, 0x36, 0x8d, 0xcf, 0xc3, + 0x9a, 0x98, 0x7e, 0x25, 0xe3, 0x73, 0xe9, 0xb7, 0x29, 0x39, 0xe2, 0x08, 0x54, 0xea, 0x89, 0xea, + 0x36, 0xac, 0xa8, 0x64, 0x54, 0x86, 0x25, 0xc2, 0x92, 0x91, 0x3f, 0x29, 0x14, 0x6a, 0x0b, 0x58, + 0x12, 0x76, 0xf3, 0xa0, 0x3d, 0xf6, 0x06, 0xc6, 0x7d, 0x58, 0xe4, 0x16, 0x50, 0x5f, 0x92, 0xd7, + 0x87, 0x82, 0x7c, 0x67, 0x40, 0x90, 0x0b, 0x4f, 0x86, 0x1d, 0x31, 0x9d, 0xb3, 0xdf, 0x34, 0x75, + 0xc5, 0xdb, 0x83, 0xc6, 0xa8, 0x62, 0x65, 0x74, 0x00, 0x92, 0x49, 0x03, 0xbd, 0x0a, 0x6b, 0xc9, + 0xac, 0xa1, 0xcc, 0x37, 0xeb, 0x53, 0x43, 0x09, 0xbb, 0x70, 0x13, 0x60, 0xaa, 0x84, 0x5f, 0x26, + 0x59, 0xef, 0xf9, 0x6a, 0xcb, 0x87, 0x65, 0xe5, 0xdb, 0x19, 0x95, 0xe0, 0x62, 0xcb, 0xd9, 0x77, + 0x1a, 0xaf, 0x3b, 0xed, 0xdd, 0x96, 0x5d, 0xaf, 0x5a, 0xb8, 0xed, 0x3e, 0x38, 0xb4, 0xf4, 0x05, + 0xb4, 0x04, 0xda, 0x7d, 0x7b, 0x57, 0xcf, 0xa0, 0x22, 0xe4, 0x77, 0x2b, 0x6f, 0x58, 0x75, 0x3d, + 0x8b, 0xd6, 0x00, 0x18, 0xea, 0xb0, 0x62, 0xee, 0x37, 0x75, 0x0d, 0x01, 0x2c, 0x9a, 0xad, 0xa6, + 0xdb, 0x38, 0xd0, 0x73, 0xf4, 0xf7, 0x7e, 0xc5, 0xb1, 0xf7, 0x1b, 0x7a, 0x9e, 0xfe, 0xae, 0x36, + 0xcc, 0x7d, 0x0b, 0xeb, 0x8b, 0x5b, 0x55, 0x28, 0xc6, 0x0f, 0x05, 0xe8, 0x12, 0xa0, 0x94, 0x3a, + 0xa9, 0x6c, 0x19, 0x96, 0xcc, 0x7a, 0xab, 0xe9, 0x5a, 0x58, 0xcf, 0x50, 0xcd, 0x7b, 0xe6, 0xae, + 0x9e, 0xa5, 0x9a, 0xeb, 0x0d, 0xb3, 0x52, 0xd7, 0xb5, 0xad, 0x06, 0x1d, 0x33, 0x93, 0x4f, 0x5d, + 0xf4, 0x14, 0xac, 0x4b, 0x41, 0x55, 0xeb, 0xb0, 0xde, 0x78, 0x90, 0x18, 0x5e, 0x80, 0x5c, 0xcd, + 0xaa, 0x1f, 0xe8, 0x19, 0xb4, 0x0a, 0xc5, 0x7d, 0x66, 0x9e, 0xfd, 0x86, 0xa5, 0x67, 0xa9, 0x92, + 0xfd, 0xd6, 0xae, 0x65, 0xba, 0x54, 0xa0, 0x0d, 0xcb, 0xca, 0x27, 0xb7, 0x1a, 0x07, 0x61, 0x88, + 0x14, 0xb7, 0x02, 0x85, 0x03, 0xdb, 0xb1, 0x29, 0xa7, 0xb0, 0x6d, 0xdf, 0xe2, 0xb6, 0x35, 0xdc, + 0x9a, 0x85, 0x75, 0x6d, 0xeb, 0x47, 0x45, 0x80, 0xa4, 0xf4, 0xa1, 0x45, 0xc8, 0x36, 0xf6, 0xf5, + 0x05, 0x54, 0x82, 0x0b, 0x4d, 0xb7, 0xe2, 0xb6, 0x9a, 0x66, 0xcd, 0x32, 0xf7, 0xdb, 0xcd, 0x96, + 0x69, 0x5a, 0xcd, 0xa6, 0xfe, 0xbb, 0x0c, 0x42, 0xb0, 0xca, 0xbd, 0x97, 0xb4, 0xdf, 0x67, 0xd0, + 0x55, 0x28, 0x71, 0xda, 0x61, 0xab, 0x59, 0x6b, 0x57, 0x18, 0xbd, 0x5d, 0xb5, 0x1c, 0xdb, 0xaa, + 0xea, 0x04, 0x5d, 0x81, 0xcb, 0x62, 0x17, 0x37, 0xee, 0x5b, 0xa6, 0xdb, 0x76, 0x1a, 0x6e, 0xfb, + 0x5e, 0xa3, 0xe5, 0x54, 0xf5, 0x23, 0x74, 0x1d, 0xca, 0xaa, 0x22, 0xfb, 0xa0, 0xb2, 0x67, 0xb5, + 0x0f, 0x5b, 0xf5, 0x7a, 0xdb, 0xc2, 0x58, 0x7f, 0x37, 0x8b, 0x3e, 0x05, 0xd7, 0x54, 0x80, 0xd9, + 0x70, 0xdc, 0x8a, 0xed, 0x58, 0xb8, 0x6d, 0x62, 0xab, 0xe2, 0xda, 0xce, 0x9e, 0xfe, 0xd3, 0x2c, + 0x32, 0xe0, 0x69, 0x15, 0x84, 0x5b, 0x8e, 0x02, 0xa4, 0x82, 0xde, 0xcb, 0xa2, 0x9b, 0xb0, 0x31, + 0x5b, 0x90, 0x6b, 0xe1, 0x03, 0xdb, 0xa9, 0xb8, 0x56, 0x55, 0xff, 0x59, 0x16, 0x3d, 0x0f, 0x9b, + 0x2a, 0x8c, 0x1f, 0xd0, 0x81, 0xe5, 0xb8, 0x6d, 0xdc, 0xa8, 0xd7, 0x1b, 0x2d, 0xb7, 0x7d, 0x68, + 0x39, 0x55, 0xaa, 0xf7, 0xe7, 0x4f, 0x90, 0x89, 0xad, 0xa6, 0x5b, 0xc1, 0xcc, 0xbc, 0x0f, 0xa6, + 0x60, 0x4e, 0xa3, 0x6a, 0xb5, 0x0f, 0xac, 0x83, 0x06, 0x7e, 0xd0, 0x3e, 0xc4, 0x56, 0xb3, 0xd9, + 0xc2, 0x96, 0xfe, 0x4d, 0x6d, 0xd2, 0x55, 0x06, 0xab, 0xda, 0xcd, 0xfd, 0x04, 0xf4, 0x2d, 0x0d, + 0x3d, 0x07, 0x37, 0xa6, 0x40, 0x8e, 0xe5, 0xbe, 0xde, 0xc0, 0xfb, 0xed, 0x96, 0x53, 0x79, 0xad, + 0x62, 0xd7, 0x2b, 0xbb, 0x75, 0x4b, 0xff, 0xb6, 0x36, 0x19, 0x15, 0x06, 0x3d, 0xb4, 0xab, 0x89, + 0xb8, 0xb7, 0x67, 0xeb, 0x6c, 0x39, 0x74, 0x55, 0x6d, 0x71, 0x41, 0xdf, 0xd1, 0xd0, 0x33, 0x70, + 0x75, 0x06, 0x08, 0x5b, 0x15, 0xb3, 0xc6, 0x20, 0xef, 0x68, 0x93, 0xe7, 0xc8, 0xcd, 0x6a, 0xb8, + 0x6d, 0x6c, 0x55, 0xaa, 0x0f, 0xf4, 0xef, 0x4e, 0x19, 0x73, 0xaf, 0x62, 0xd7, 0xad, 0x6a, 0x5b, + 0x28, 0xa2, 0x71, 0xfa, 0x9e, 0x86, 0xca, 0xb0, 0xae, 0x62, 0x5a, 0x4e, 0xcd, 0xaa, 0xd4, 0xdd, + 0xda, 0x03, 0xfd, 0xfb, 0x1a, 0x7a, 0x16, 0x0c, 0x75, 0x4f, 0x5c, 0x06, 0x1a, 0x72, 0xc7, 0x32, + 0x5d, 0xbb, 0xe1, 0xb0, 0x73, 0xfe, 0xc1, 0x94, 0x47, 0x12, 0x48, 0x1d, 0xdf, 0xb7, 0xeb, 0x75, + 0xab, 0xaa, 0xff, 0x50, 0xa3, 0x59, 0x2c, 0xaf, 0x8c, 0x85, 0x71, 0x03, 0xeb, 0x1f, 0x6a, 0x93, + 0x39, 0x2f, 0xf6, 0xf5, 0x8f, 0x34, 0xb4, 0x09, 0xcf, 0xcc, 0xd8, 0x99, 0x88, 0xd3, 0xdf, 0x34, + 0xb4, 0x05, 0x37, 0x67, 0xa7, 0xc3, 0xeb, 0x15, 0x9b, 0xe6, 0x42, 0x2c, 0xf3, 0xef, 0x1a, 0xba, + 0x06, 0x4f, 0xcd, 0x92, 0x69, 0xbd, 0x66, 0x39, 0xae, 0xfe, 0x5f, 0x0d, 0x5d, 0x80, 0x35, 0x9e, + 0x7b, 0x31, 0xd3, 0x3f, 0x34, 0x74, 0x1e, 0x56, 0x9a, 0x0f, 0x1c, 0x33, 0x26, 0xfd, 0x53, 0x4b, + 0xee, 0xa3, 0xa4, 0xfd, 0x4b, 0x43, 0x17, 0xe1, 0x5c, 0xd5, 0x7a, 0xcd, 0x76, 0x6c, 0x37, 0xa6, + 0xfe, 0x9b, 0x51, 0xcd, 0xba, 0x55, 0x71, 0x5a, 0x87, 0x31, 0xf5, 0x3f, 0x8c, 0xca, 0x44, 0x32, + 0x34, 0x8f, 0xc5, 0x9f, 0x72, 0x68, 0x03, 0xae, 0x48, 0x09, 0xd8, 0xda, 0xb3, 0x59, 0x4d, 0xe1, + 0x6a, 0xaa, 0xd6, 0x61, 0x53, 0xff, 0x55, 0x9e, 0x1e, 0xf8, 0x14, 0xc2, 0xb5, 0x9a, 0x2e, 0x07, + 0xfc, 0x3a, 0x4f, 0x93, 0x66, 0x0a, 0x20, 0x3c, 0x62, 0x90, 0xf7, 0xf3, 0x33, 0xb5, 0x98, 0x0d, + 0xe7, 0x9e, 0xbd, 0x47, 0x21, 0xfa, 0x6f, 0xf2, 0x5b, 0x4f, 0xc1, 0x5a, 0xba, 0x57, 0xd0, 0x22, + 0xe6, 0xd8, 0x75, 0x7d, 0xe1, 0xa5, 0x5f, 0xe4, 0xe1, 0x5c, 0x53, 0xfc, 0xfb, 0xa8, 0x49, 0x82, + 0xc7, 0xfd, 0x0e, 0x41, 0x26, 0x14, 0xf6, 0x48, 0x24, 0x9e, 0x9e, 0xa6, 0x5a, 0xbd, 0x75, 0x3c, + 0x8a, 0x4e, 0xca, 0xa9, 0x7f, 0xf0, 0x18, 0xe7, 0xbf, 0xfe, 0x87, 0x0f, 0xde, 0xce, 0x2e, 0xa3, + 0xe2, 0xce, 0xe3, 0xdb, 0x3b, 0xac, 0x93, 0xa2, 0x3d, 0x28, 0xb0, 0x46, 0x5f, 0xf7, 0x7b, 0x48, + 0x7e, 0xf0, 0xca, 0x99, 0xa2, 0x3c, 0x49, 0x30, 0xd6, 0x99, 0x80, 0x73, 0x68, 0x95, 0x0a, 0xe0, + 0x6f, 0x0b, 0x03, 0xbf, 0x77, 0x2b, 0xf3, 0x62, 0x06, 0xed, 0xc1, 0x22, 0x13, 0x14, 0xce, 0xb5, + 0x65, 0x4a, 0x1a, 0x62, 0xd2, 0x56, 0x10, 0xc4, 0xd2, 0xc2, 0x17, 0x33, 0xe8, 0x4b, 0xb0, 0x64, + 0x7d, 0x95, 0x74, 0xc6, 0x11, 0x41, 0x25, 0xc1, 0x31, 0x35, 0x64, 0x94, 0xe7, 0xe8, 0x30, 0xae, + 0x30, 0x91, 0xeb, 0xc6, 0x32, 0x13, 0xc9, 0xc5, 0xdc, 0x15, 0x23, 0x07, 0xf2, 0xa0, 0x58, 0x19, + 0x47, 0x3e, 0x6b, 0x72, 0x68, 0x3d, 0x3d, 0x5e, 0x9c, 0x26, 0xf8, 0x26, 0x13, 0x7c, 0xbd, 0x7c, + 0x89, 0x0a, 0x66, 0x13, 0xc3, 0x8e, 0x37, 0x8e, 0xfc, 0xb6, 0xd4, 0xc1, 0x07, 0x13, 0xd4, 0x86, + 0x02, 0x55, 0x41, 0x07, 0xfc, 0xb3, 0x6a, 0xb8, 0xc1, 0x34, 0x5c, 0x2b, 0xaf, 0xb3, 0xc3, 0x39, + 0x19, 0x76, 0x66, 0x2a, 0xe8, 0x00, 0x50, 0x05, 0xbc, 0xc5, 0x9e, 0x55, 0xc5, 0x26, 0x53, 0xb1, + 0x51, 0xbe, 0x4c, 0x55, 0xf0, 0x59, 0x66, 0xa6, 0x92, 0x3a, 0x2c, 0xd6, 0xbc, 0x61, 0x77, 0x40, + 0x50, 0x6a, 0x18, 0x9c, 0x2b, 0xf7, 0x2a, 0x93, 0x7b, 0xc9, 0x38, 0x9f, 0x1c, 0xe4, 0xce, 0x9b, + 0x4c, 0xc0, 0xdd, 0xcc, 0xd6, 0xc3, 0x45, 0x86, 0xbe, 0xf3, 0xbf, 0x00, 0x00, 0x00, 0xff, 0xff, + 0xf7, 0xa1, 0x48, 0x69, 0x00, 0x1d, 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. diff --git a/proto/skaffold.proto b/proto/skaffold.proto index ee8c79e38cf..ab4ff74db5d 100644 --- a/proto/skaffold.proto +++ b/proto/skaffold.proto @@ -115,14 +115,15 @@ message Event { message DevLoopEvent { int32 iteration = 1; // dev loop iteration. 0 represents initialization loop. string status = 2; // dev loop status oneof: In Progress, Completed, Failed - ErrDef err = 3; // actionable error message + ActionableErr err = 3; // actionable error message } -// `ErrDef` defines an error occurred along with an optional suggestions -message ErrDef { +// `ActionableErr` defines an error occurred along with an optional suggestions +message ActionableErr { StatusCode errCode = 1; // error code representing the error string message = 2; // message describing the error. + repeated Suggestion suggestions = 3; // list of suggestions } // `MetaEvent` provides general information regarding Skaffold @@ -138,24 +139,28 @@ message MetaEvent { message BuildEvent { string artifact = 1; // artifact name string status = 2; // artifact build status oneof: InProgress, Completed, Failed - string err = 3; // error when build status is Failed. - StatusCode errCode = 4; // status code representing success or failure + string err = 3; // Deprecated. Use actionableErr.message. error when build status is Failed. + StatusCode errCode = 4; // Deprecated. Use actionableErr.errCode. status code representing success or failure + ActionableErr actionableErr = 5; // actionable error message + } // `DeployEvent` represents the status of a deployment, and is emitted by Skaffold // anytime a deployment starts or completes, successfully or not. message DeployEvent { string status = 1; // deployment status oneof: InProgress, Completed, Failed - string err = 2; // error when status is Failed - StatusCode errCode = 3; // status code representing success or failure + string err = 2; // Deprecated. Use actionableErr.message. error when status is Failed + StatusCode errCode = 3; // Deprecated. Use actionableErr.errCode. status code representing success or failure + ActionableErr actionableErr = 4; // actionable error message } // `StatusCheckEvent` describes if the status check for kubernetes rollout has started, is in progress, has succeeded or failed. message StatusCheckEvent { string status = 1; string message = 2; - string err = 3; - StatusCode errCode = 4; // status code representing success or failure + string err = 3; // Deprecated. Use actionableErr.message. + StatusCode errCode = 4; // Deprecated. Use actionableErr.errCode. status code representing success or failure + ActionableErr actionableErr = 5; // actionable error message } // A Resource StatusCheck Event, indicates progress for each kubernetes deployment. @@ -167,8 +172,9 @@ message ResourceStatusCheckEvent { string resource = 1; string status = 2; string message = 3; - string err = 4; + string err = 4; // Deprecated. Use actionableErr.message. StatusCode statusCode = 5; + ActionableErr actionableErr = 6; // actionable error message } // PortEvent Event describes each port forwarding event. @@ -177,7 +183,7 @@ message PortEvent { int32 remotePort = 2; // remote port is the resource port that will be forwarded. string podName = 3; // pod name if port forwarded resourceType is Pod string containerName = 4; // container name if specified in the kubernetes spec - string namespace = 5; // the namespace of the resource to port forward. + string namespace = 5; // the namespace of the resource to port forward. string portName = 6; string resourceType = 7; // resource type e.g. "pod", "service". string resourceName = 8; // name of the resource to forward. @@ -189,8 +195,9 @@ message FileSyncEvent { int32 fileCount = 1; // number of files synced string image = 2; // the container image to which files are sycned. string status = 3; // status of file sync. one of: Not Started, In progress, Succeeded, Failed. - string err = 4; // error in case of status failed. - StatusCode errCode = 5; // status code representing success or failure + string err = 4; // Deprecated. Use actionableErr.message. error in case of status failed. + StatusCode errCode = 5; //// Deprecated. Use actionableErr.errCode. status code representing success or failure + ActionableErr actionableErr = 6; // actionable error message } // DebuggingContainerEvent is raised when a debugging container is started or terminated @@ -235,6 +242,12 @@ message Intent { bool deploy = 3; // in case skaffold dev is ran with autoDeploy=false, a deploy intent enables deploys once } +// Suggestion defines the action a user needs to recover from an error. +message Suggestion { + SuggestionCode suggestionCode = 1; // code representing a suggestion + string action = 2; // action represents the suggestion action +} + // Describes all the methods for the Skaffold API service SkaffoldService { @@ -460,3 +473,11 @@ enum StatusCode { // Failed to configure watcher for Skaffold configuration file. DEVINIT_REGISTER_CONFIG_DEP = 704; } + +// Enum for Suggestion codes +enum SuggestionCode { + // default nil suggestion. + // This is usually set when no error happens. + NIL = 0; + +} \ No newline at end of file From 1d302c6cb4d0dab93d4e46ce0b2859a5ca37f08f Mon Sep 17 00:00:00 2001 From: Tejal Desai Date: Mon, 22 Jun 2020 14:30:33 -0700 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: Nick Kubala --- proto/skaffold.proto | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/proto/skaffold.proto b/proto/skaffold.proto index ab4ff74db5d..42e985633b1 100644 --- a/proto/skaffold.proto +++ b/proto/skaffold.proto @@ -119,7 +119,7 @@ message DevLoopEvent { } -// `ActionableErr` defines an error occurred along with an optional suggestions +// `ActionableErr` defines an error that occurred along with an optional list of suggestions message ActionableErr { StatusCode errCode = 1; // error code representing the error string message = 2; // message describing the error. @@ -480,4 +480,4 @@ enum SuggestionCode { // This is usually set when no error happens. NIL = 0; -} \ No newline at end of file +} From 5e1869d3d27511f23f8993b18ad467cf0c6c3c73 Mon Sep 17 00:00:00 2001 From: tejal29 Date: Mon, 22 Jun 2020 14:51:20 -0700 Subject: [PATCH 3/3] regenarte docs --- docs/content/en/api/skaffold.swagger.json | 2 +- docs/content/en/docs/references/api/grpc.md | 2 +- proto/skaffold.pb.go | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/content/en/api/skaffold.swagger.json b/docs/content/en/api/skaffold.swagger.json index 27962bde4b5..c6e5b8fad8e 100644 --- a/docs/content/en/api/skaffold.swagger.json +++ b/docs/content/en/api/skaffold.swagger.json @@ -1061,7 +1061,7 @@ } } }, - "description": "`ActionableErr` defines an error occurred along with an optional suggestions" + "description": "`ActionableErr` defines an error that occurred along with an optional list of suggestions" }, "protoBuildEvent": { "type": "object", diff --git a/docs/content/en/docs/references/api/grpc.md b/docs/content/en/docs/references/api/grpc.md index 78f633b7c6a..0ff1eee0693 100644 --- a/docs/content/en/docs/references/api/grpc.md +++ b/docs/content/en/docs/references/api/grpc.md @@ -54,7 +54,7 @@ Describes all the methods for the Skaffold API #### ActionableErr -`ActionableErr` defines an error occurred along with an optional suggestions +`ActionableErr` defines an error that occurred along with an optional list of suggestions | Field | Type | Label | Description | diff --git a/proto/skaffold.pb.go b/proto/skaffold.pb.go index e652d317e8e..08b37aadd7f 100644 --- a/proto/skaffold.pb.go +++ b/proto/skaffold.pb.go @@ -1293,7 +1293,7 @@ func (m *DevLoopEvent) GetErr() *ActionableErr { return nil } -// `ActionableErr` defines an error occurred along with an optional suggestions +// `ActionableErr` defines an error that occurred along with an optional list of suggestions type ActionableErr struct { ErrCode StatusCode `protobuf:"varint,1,opt,name=errCode,proto3,enum=proto.StatusCode" json:"errCode,omitempty"` Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`