github.com/GoogleContainerTools/skaffold/v2@v2.13.2/docs-v2/content/en/schemas/v1beta11.json (about) 1 { 2 "type": "object", 3 "anyOf": [ 4 { 5 "$ref": "#/definitions/SkaffoldConfig" 6 } 7 ], 8 "$schema": "http://json-schema.org/draft-07/schema#", 9 "definitions": { 10 "Activation": { 11 "properties": { 12 "command": { 13 "type": "string", 14 "description": "a Skaffold command for which the profile is auto-activated.", 15 "x-intellij-html-description": "a Skaffold command for which the profile is auto-activated.", 16 "examples": [ 17 "dev" 18 ] 19 }, 20 "env": { 21 "type": "string", 22 "description": "a `key=value` pair. The profile is auto-activated if an Environment Variable `key` has value `value`.", 23 "x-intellij-html-description": "a <code>key=value</code> pair. The profile is auto-activated if an Environment Variable <code>key</code> has value <code>value</code>.", 24 "examples": [ 25 "ENV=production" 26 ] 27 }, 28 "kubeContext": { 29 "type": "string", 30 "description": "a Kubernetes context for which the profile is auto-activated.", 31 "x-intellij-html-description": "a Kubernetes context for which the profile is auto-activated.", 32 "examples": [ 33 "minikube" 34 ] 35 } 36 }, 37 "preferredOrder": [ 38 "env", 39 "kubeContext", 40 "command" 41 ], 42 "additionalProperties": false, 43 "type": "object", 44 "description": "criteria by which a profile is auto-activated.", 45 "x-intellij-html-description": "criteria by which a profile is auto-activated." 46 }, 47 "Artifact": { 48 "required": [ 49 "image" 50 ], 51 "type": "object", 52 "anyOf": [ 53 { 54 "properties": { 55 "context": { 56 "type": "string", 57 "description": "directory containing the artifact's sources.", 58 "x-intellij-html-description": "directory containing the artifact's sources.", 59 "default": "." 60 }, 61 "image": { 62 "type": "string", 63 "description": "name of the image to be built.", 64 "x-intellij-html-description": "name of the image to be built.", 65 "examples": [ 66 "gcr.io/k8s-skaffold/example" 67 ] 68 }, 69 "sync": { 70 "$ref": "#/definitions/Sync", 71 "description": "*alpha* local files synced to pods instead of triggering an image build when modified.", 72 "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified." 73 } 74 }, 75 "preferredOrder": [ 76 "image", 77 "context", 78 "sync" 79 ], 80 "additionalProperties": false 81 }, 82 { 83 "properties": { 84 "context": { 85 "type": "string", 86 "description": "directory containing the artifact's sources.", 87 "x-intellij-html-description": "directory containing the artifact's sources.", 88 "default": "." 89 }, 90 "docker": { 91 "$ref": "#/definitions/DockerArtifact", 92 "description": "*beta* describes an artifact built from a Dockerfile.", 93 "x-intellij-html-description": "<em>beta</em> describes an artifact built from a Dockerfile." 94 }, 95 "image": { 96 "type": "string", 97 "description": "name of the image to be built.", 98 "x-intellij-html-description": "name of the image to be built.", 99 "examples": [ 100 "gcr.io/k8s-skaffold/example" 101 ] 102 }, 103 "sync": { 104 "$ref": "#/definitions/Sync", 105 "description": "*alpha* local files synced to pods instead of triggering an image build when modified.", 106 "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified." 107 } 108 }, 109 "preferredOrder": [ 110 "image", 111 "context", 112 "sync", 113 "docker" 114 ], 115 "additionalProperties": false 116 }, 117 { 118 "properties": { 119 "bazel": { 120 "$ref": "#/definitions/BazelArtifact", 121 "description": "*beta* requires bazel CLI to be installed and the sources to contain [Bazel](https://bazel.build/) configuration files.", 122 "x-intellij-html-description": "<em>beta</em> requires bazel CLI to be installed and the sources to contain <a href=\"https://bazel.build/\">Bazel</a> configuration files." 123 }, 124 "context": { 125 "type": "string", 126 "description": "directory containing the artifact's sources.", 127 "x-intellij-html-description": "directory containing the artifact's sources.", 128 "default": "." 129 }, 130 "image": { 131 "type": "string", 132 "description": "name of the image to be built.", 133 "x-intellij-html-description": "name of the image to be built.", 134 "examples": [ 135 "gcr.io/k8s-skaffold/example" 136 ] 137 }, 138 "sync": { 139 "$ref": "#/definitions/Sync", 140 "description": "*alpha* local files synced to pods instead of triggering an image build when modified.", 141 "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified." 142 } 143 }, 144 "preferredOrder": [ 145 "image", 146 "context", 147 "sync", 148 "bazel" 149 ], 150 "additionalProperties": false 151 }, 152 { 153 "properties": { 154 "context": { 155 "type": "string", 156 "description": "directory containing the artifact's sources.", 157 "x-intellij-html-description": "directory containing the artifact's sources.", 158 "default": "." 159 }, 160 "image": { 161 "type": "string", 162 "description": "name of the image to be built.", 163 "x-intellij-html-description": "name of the image to be built.", 164 "examples": [ 165 "gcr.io/k8s-skaffold/example" 166 ] 167 }, 168 "jibMaven": { 169 "$ref": "#/definitions/JibMavenArtifact", 170 "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).", 171 "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>." 172 }, 173 "sync": { 174 "$ref": "#/definitions/Sync", 175 "description": "*alpha* local files synced to pods instead of triggering an image build when modified.", 176 "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified." 177 } 178 }, 179 "preferredOrder": [ 180 "image", 181 "context", 182 "sync", 183 "jibMaven" 184 ], 185 "additionalProperties": false 186 }, 187 { 188 "properties": { 189 "context": { 190 "type": "string", 191 "description": "directory containing the artifact's sources.", 192 "x-intellij-html-description": "directory containing the artifact's sources.", 193 "default": "." 194 }, 195 "image": { 196 "type": "string", 197 "description": "name of the image to be built.", 198 "x-intellij-html-description": "name of the image to be built.", 199 "examples": [ 200 "gcr.io/k8s-skaffold/example" 201 ] 202 }, 203 "jibGradle": { 204 "$ref": "#/definitions/JibGradleArtifact", 205 "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).", 206 "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>." 207 }, 208 "sync": { 209 "$ref": "#/definitions/Sync", 210 "description": "*alpha* local files synced to pods instead of triggering an image build when modified.", 211 "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified." 212 } 213 }, 214 "preferredOrder": [ 215 "image", 216 "context", 217 "sync", 218 "jibGradle" 219 ], 220 "additionalProperties": false 221 }, 222 { 223 "properties": { 224 "context": { 225 "type": "string", 226 "description": "directory containing the artifact's sources.", 227 "x-intellij-html-description": "directory containing the artifact's sources.", 228 "default": "." 229 }, 230 "image": { 231 "type": "string", 232 "description": "name of the image to be built.", 233 "x-intellij-html-description": "name of the image to be built.", 234 "examples": [ 235 "gcr.io/k8s-skaffold/example" 236 ] 237 }, 238 "kaniko": { 239 "$ref": "#/definitions/KanikoArtifact", 240 "description": "*alpha* builds images using [kaniko](https://github.com/GoogleContainerTools/kaniko).", 241 "x-intellij-html-description": "<em>alpha</em> builds images using <a href=\"https://github.com/GoogleContainerTools/kaniko\">kaniko</a>." 242 }, 243 "sync": { 244 "$ref": "#/definitions/Sync", 245 "description": "*alpha* local files synced to pods instead of triggering an image build when modified.", 246 "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified." 247 } 248 }, 249 "preferredOrder": [ 250 "image", 251 "context", 252 "sync", 253 "kaniko" 254 ], 255 "additionalProperties": false 256 }, 257 { 258 "properties": { 259 "context": { 260 "type": "string", 261 "description": "directory containing the artifact's sources.", 262 "x-intellij-html-description": "directory containing the artifact's sources.", 263 "default": "." 264 }, 265 "custom": { 266 "$ref": "#/definitions/CustomArtifact", 267 "description": "*alpha* builds images using a custom build script written by the user.", 268 "x-intellij-html-description": "<em>alpha</em> builds images using a custom build script written by the user." 269 }, 270 "image": { 271 "type": "string", 272 "description": "name of the image to be built.", 273 "x-intellij-html-description": "name of the image to be built.", 274 "examples": [ 275 "gcr.io/k8s-skaffold/example" 276 ] 277 }, 278 "sync": { 279 "$ref": "#/definitions/Sync", 280 "description": "*alpha* local files synced to pods instead of triggering an image build when modified.", 281 "x-intellij-html-description": "<em>alpha</em> local files synced to pods instead of triggering an image build when modified." 282 } 283 }, 284 "preferredOrder": [ 285 "image", 286 "context", 287 "sync", 288 "custom" 289 ], 290 "additionalProperties": false 291 } 292 ], 293 "description": "items that need to be built, along with the context in which they should be built.", 294 "x-intellij-html-description": "items that need to be built, along with the context in which they should be built." 295 }, 296 "BazelArtifact": { 297 "required": [ 298 "target" 299 ], 300 "properties": { 301 "args": { 302 "items": { 303 "type": "string" 304 }, 305 "type": "array", 306 "description": "additional args to pass to `bazel build`.", 307 "x-intellij-html-description": "additional args to pass to <code>bazel build</code>.", 308 "default": "[]", 309 "examples": [ 310 "[\"-flag\", \"--otherflag\"]" 311 ] 312 }, 313 "target": { 314 "type": "string", 315 "description": "`bazel build` target to run.", 316 "x-intellij-html-description": "<code>bazel build</code> target to run.", 317 "examples": [ 318 "//:skaffold_example.tar" 319 ] 320 } 321 }, 322 "preferredOrder": [ 323 "target", 324 "args" 325 ], 326 "additionalProperties": false, 327 "type": "object", 328 "description": "*beta* describes an artifact built with [Bazel](https://bazel.build/).", 329 "x-intellij-html-description": "<em>beta</em> describes an artifact built with <a href=\"https://bazel.build/\">Bazel</a>." 330 }, 331 "BuildConfig": { 332 "type": "object", 333 "anyOf": [ 334 { 335 "properties": { 336 "artifacts": { 337 "items": { 338 "$ref": "#/definitions/Artifact" 339 }, 340 "type": "array", 341 "description": "the images you're going to be building.", 342 "x-intellij-html-description": "the images you're going to be building." 343 }, 344 "insecureRegistries": { 345 "items": { 346 "type": "string" 347 }, 348 "type": "array", 349 "description": "a list of registries declared by the user to be insecure. These registries will be connected to via HTTP instead of HTTPS.", 350 "x-intellij-html-description": "a list of registries declared by the user to be insecure. These registries will be connected to via HTTP instead of HTTPS.", 351 "default": "[]" 352 }, 353 "tagPolicy": { 354 "$ref": "#/definitions/TagPolicy", 355 "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {variant: Tags}`.", 356 "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {variant: Tags}</code>." 357 } 358 }, 359 "preferredOrder": [ 360 "artifacts", 361 "insecureRegistries", 362 "tagPolicy" 363 ], 364 "additionalProperties": false 365 }, 366 { 367 "properties": { 368 "artifacts": { 369 "items": { 370 "$ref": "#/definitions/Artifact" 371 }, 372 "type": "array", 373 "description": "the images you're going to be building.", 374 "x-intellij-html-description": "the images you're going to be building." 375 }, 376 "insecureRegistries": { 377 "items": { 378 "type": "string" 379 }, 380 "type": "array", 381 "description": "a list of registries declared by the user to be insecure. These registries will be connected to via HTTP instead of HTTPS.", 382 "x-intellij-html-description": "a list of registries declared by the user to be insecure. These registries will be connected to via HTTP instead of HTTPS.", 383 "default": "[]" 384 }, 385 "local": { 386 "$ref": "#/definitions/LocalBuild", 387 "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.", 388 "x-intellij-html-description": "<em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository." 389 }, 390 "tagPolicy": { 391 "$ref": "#/definitions/TagPolicy", 392 "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {variant: Tags}`.", 393 "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {variant: Tags}</code>." 394 } 395 }, 396 "preferredOrder": [ 397 "artifacts", 398 "insecureRegistries", 399 "tagPolicy", 400 "local" 401 ], 402 "additionalProperties": false 403 }, 404 { 405 "properties": { 406 "artifacts": { 407 "items": { 408 "$ref": "#/definitions/Artifact" 409 }, 410 "type": "array", 411 "description": "the images you're going to be building.", 412 "x-intellij-html-description": "the images you're going to be building." 413 }, 414 "googleCloudBuild": { 415 "$ref": "#/definitions/GoogleCloudBuild", 416 "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/).", 417 "x-intellij-html-description": "<em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/\">Google Cloud Build</a>." 418 }, 419 "insecureRegistries": { 420 "items": { 421 "type": "string" 422 }, 423 "type": "array", 424 "description": "a list of registries declared by the user to be insecure. These registries will be connected to via HTTP instead of HTTPS.", 425 "x-intellij-html-description": "a list of registries declared by the user to be insecure. These registries will be connected to via HTTP instead of HTTPS.", 426 "default": "[]" 427 }, 428 "tagPolicy": { 429 "$ref": "#/definitions/TagPolicy", 430 "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {variant: Tags}`.", 431 "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {variant: Tags}</code>." 432 } 433 }, 434 "preferredOrder": [ 435 "artifacts", 436 "insecureRegistries", 437 "tagPolicy", 438 "googleCloudBuild" 439 ], 440 "additionalProperties": false 441 }, 442 { 443 "properties": { 444 "artifacts": { 445 "items": { 446 "$ref": "#/definitions/Artifact" 447 }, 448 "type": "array", 449 "description": "the images you're going to be building.", 450 "x-intellij-html-description": "the images you're going to be building." 451 }, 452 "cluster": { 453 "$ref": "#/definitions/ClusterDetails", 454 "description": "*beta* describes how to do an on-cluster build.", 455 "x-intellij-html-description": "<em>beta</em> describes how to do an on-cluster build." 456 }, 457 "insecureRegistries": { 458 "items": { 459 "type": "string" 460 }, 461 "type": "array", 462 "description": "a list of registries declared by the user to be insecure. These registries will be connected to via HTTP instead of HTTPS.", 463 "x-intellij-html-description": "a list of registries declared by the user to be insecure. These registries will be connected to via HTTP instead of HTTPS.", 464 "default": "[]" 465 }, 466 "tagPolicy": { 467 "$ref": "#/definitions/TagPolicy", 468 "description": "*beta* determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to `gitCommit: {variant: Tags}`.", 469 "x-intellij-html-description": "<em>beta</em> determines how images are tagged. A few strategies are provided here, although you most likely won't need to care! If not specified, it defaults to <code>gitCommit: {variant: Tags}</code>." 470 } 471 }, 472 "preferredOrder": [ 473 "artifacts", 474 "insecureRegistries", 475 "tagPolicy", 476 "cluster" 477 ], 478 "additionalProperties": false 479 } 480 ], 481 "description": "contains all the configuration for the build steps.", 482 "x-intellij-html-description": "contains all the configuration for the build steps." 483 }, 484 "ClusterDetails": { 485 "properties": { 486 "dockerConfig": { 487 "$ref": "#/definitions/DockerConfig", 488 "description": "describes how to mount the local Docker configuration into a pod.", 489 "x-intellij-html-description": "describes how to mount the local Docker configuration into a pod." 490 }, 491 "namespace": { 492 "type": "string", 493 "description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration.", 494 "x-intellij-html-description": "Kubernetes namespace. Defaults to current namespace in Kubernetes configuration." 495 }, 496 "pullSecret": { 497 "type": "string", 498 "description": "path to the Google Cloud service account secret key file.", 499 "x-intellij-html-description": "path to the Google Cloud service account secret key file." 500 }, 501 "pullSecretName": { 502 "type": "string", 503 "description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image. If given, the secret needs to contain the Google Cloud service account secret key under the key `kaniko-secret`.", 504 "x-intellij-html-description": "name of the Kubernetes secret for pulling the files from the build context and pushing the final image. If given, the secret needs to contain the Google Cloud service account secret key under the key <code>kaniko-secret</code>.", 505 "default": "kaniko-secret" 506 }, 507 "resources": { 508 "$ref": "#/definitions/ResourceRequirements", 509 "description": "define the resource requirements for the kaniko pod.", 510 "x-intellij-html-description": "define the resource requirements for the kaniko pod." 511 }, 512 "timeout": { 513 "type": "string", 514 "description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (`20m`).", 515 "x-intellij-html-description": "amount of time (in seconds) that this build is allowed to run. Defaults to 20 minutes (<code>20m</code>)." 516 } 517 }, 518 "preferredOrder": [ 519 "pullSecret", 520 "pullSecretName", 521 "namespace", 522 "timeout", 523 "dockerConfig", 524 "resources" 525 ], 526 "additionalProperties": false, 527 "type": "object", 528 "description": "*beta* describes how to do an on-cluster build.", 529 "x-intellij-html-description": "<em>beta</em> describes how to do an on-cluster build." 530 }, 531 "CustomArtifact": { 532 "properties": { 533 "buildCommand": { 534 "type": "string", 535 "description": "command executed to build the image.", 536 "x-intellij-html-description": "command executed to build the image." 537 }, 538 "dependencies": { 539 "$ref": "#/definitions/CustomDependencies", 540 "description": "file dependencies that skaffold should watch for both rebuilding and file syncing for this artifact.", 541 "x-intellij-html-description": "file dependencies that skaffold should watch for both rebuilding and file syncing for this artifact." 542 } 543 }, 544 "preferredOrder": [ 545 "buildCommand", 546 "dependencies" 547 ], 548 "additionalProperties": false, 549 "type": "object", 550 "description": "*alpha* describes an artifact built from a custom build script written by the user. It can be used to build images with builders that aren't directly integrated with skaffold.", 551 "x-intellij-html-description": "<em>alpha</em> describes an artifact built from a custom build script written by the user. It can be used to build images with builders that aren't directly integrated with skaffold." 552 }, 553 "CustomDependencies": { 554 "properties": { 555 "command": { 556 "type": "string", 557 "description": "represents a custom command that skaffold executes to obtain dependencies. The output of this command *must* be a valid JSON array.", 558 "x-intellij-html-description": "represents a custom command that skaffold executes to obtain dependencies. The output of this command <em>must</em> be a valid JSON array." 559 }, 560 "dockerfile": { 561 "$ref": "#/definitions/DockerfileDependency", 562 "description": "should be set if the artifact is built from a Dockerfile, from which skaffold can determine dependencies.", 563 "x-intellij-html-description": "should be set if the artifact is built from a Dockerfile, from which skaffold can determine dependencies." 564 }, 565 "ignore": { 566 "items": { 567 "type": "string" 568 }, 569 "type": "array", 570 "description": "specifies the paths that should be ignored by skaffold's file watcher. If a file exists in both `paths` and in `ignore`, it will be ignored, and will be excluded from both rebuilds and file synchronization. Will only work in conjunction with `paths`.", 571 "x-intellij-html-description": "specifies the paths that should be ignored by skaffold's file watcher. If a file exists in both <code>paths</code> and in <code>ignore</code>, it will be ignored, and will be excluded from both rebuilds and file synchronization. Will only work in conjunction with <code>paths</code>.", 572 "default": "[]" 573 }, 574 "paths": { 575 "items": { 576 "type": "string" 577 }, 578 "type": "array", 579 "description": "should be set to the file dependencies for this artifact, so that the skaffold file watcher knows when to rebuild and perform file synchronization.", 580 "x-intellij-html-description": "should be set to the file dependencies for this artifact, so that the skaffold file watcher knows when to rebuild and perform file synchronization.", 581 "default": "[]" 582 } 583 }, 584 "preferredOrder": [ 585 "dockerfile", 586 "command", 587 "paths", 588 "ignore" 589 ], 590 "additionalProperties": false, 591 "type": "object", 592 "description": "*alpha* used to specify dependencies for an artifact built by a custom build script. Either `dockerfile` or `paths` should be specified for file watching to work as expected.", 593 "x-intellij-html-description": "<em>alpha</em> used to specify dependencies for an artifact built by a custom build script. Either <code>dockerfile</code> or <code>paths</code> should be specified for file watching to work as expected." 594 }, 595 "DateTimeTagger": { 596 "properties": { 597 "format": { 598 "type": "string", 599 "description": "formats the date and time. See [#Time.Format](https://golang.org/pkg/time/#Time.Format).", 600 "x-intellij-html-description": "formats the date and time. See <a href=\"https://golang.org/pkg/time/#Time.Format\">#Time.Format</a>.", 601 "default": "2006-01-02_15-04-05.999_MST" 602 }, 603 "timezone": { 604 "type": "string", 605 "description": "sets the timezone for the date and time. See [Time.LoadLocation](https://golang.org/pkg/time/#Time.LoadLocation). Defaults to the local timezone.", 606 "x-intellij-html-description": "sets the timezone for the date and time. See <a href=\"https://golang.org/pkg/time/#Time.LoadLocation\">Time.LoadLocation</a>. Defaults to the local timezone." 607 } 608 }, 609 "preferredOrder": [ 610 "format", 611 "timezone" 612 ], 613 "additionalProperties": false, 614 "type": "object", 615 "description": "*beta* tags images with the build timestamp.", 616 "x-intellij-html-description": "<em>beta</em> tags images with the build timestamp." 617 }, 618 "DeployConfig": { 619 "type": "object", 620 "anyOf": [ 621 { 622 "additionalProperties": false 623 }, 624 { 625 "properties": { 626 "helm": { 627 "$ref": "#/definitions/HelmDeploy", 628 "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.", 629 "x-intellij-html-description": "<em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster." 630 } 631 }, 632 "preferredOrder": [ 633 "helm" 634 ], 635 "additionalProperties": false 636 }, 637 { 638 "properties": { 639 "kubectl": { 640 "$ref": "#/definitions/KubectlDeploy", 641 "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.", 642 "x-intellij-html-description": "<em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster." 643 } 644 }, 645 "preferredOrder": [ 646 "kubectl" 647 ], 648 "additionalProperties": false 649 }, 650 { 651 "properties": { 652 "kustomize": { 653 "$ref": "#/definitions/KustomizeDeploy", 654 "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.", 655 "x-intellij-html-description": "<em>beta</em> uses the <code>kustomize</code> CLI to "patch" a deployment for a target environment." 656 } 657 }, 658 "preferredOrder": [ 659 "kustomize" 660 ], 661 "additionalProperties": false 662 } 663 ], 664 "description": "contains all the configuration needed by the deploy steps.", 665 "x-intellij-html-description": "contains all the configuration needed by the deploy steps." 666 }, 667 "DockerArtifact": { 668 "properties": { 669 "buildArgs": { 670 "additionalProperties": { 671 "type": "string" 672 }, 673 "type": "object", 674 "description": "arguments passed to the docker build.", 675 "x-intellij-html-description": "arguments passed to the docker build.", 676 "default": "{}", 677 "examples": [ 678 "{\"key1\": \"value1\", \"key2\": \"value2\"}" 679 ] 680 }, 681 "cacheFrom": { 682 "items": { 683 "type": "string" 684 }, 685 "type": "array", 686 "description": "the Docker images used as cache sources.", 687 "x-intellij-html-description": "the Docker images used as cache sources.", 688 "default": "[]", 689 "examples": [ 690 "[\"golang:1.10.1-alpine3.7\", \"alpine:3.7\"]" 691 ] 692 }, 693 "dockerfile": { 694 "type": "string", 695 "description": "locates the Dockerfile relative to workspace.", 696 "x-intellij-html-description": "locates the Dockerfile relative to workspace.", 697 "default": "Dockerfile" 698 }, 699 "network": { 700 "type": "string", 701 "description": "passed through to docker and overrides the network configuration of docker builder. If unset, use whatever is configured in the underlying docker daemon. Valid modes are `host`: use the host's networking stack. `bridge`: use the bridged network configuration. `none`: no networking in the container.", 702 "x-intellij-html-description": "passed through to docker and overrides the network configuration of docker builder. If unset, use whatever is configured in the underlying docker daemon. Valid modes are <code>host</code>: use the host's networking stack. <code>bridge</code>: use the bridged network configuration. <code>none</code>: no networking in the container.", 703 "enum": [ 704 "host", 705 "bridge", 706 "none" 707 ] 708 }, 709 "noCache": { 710 "type": "boolean", 711 "description": "used to pass in --no-cache to docker build to prevent caching.", 712 "x-intellij-html-description": "used to pass in --no-cache to docker build to prevent caching.", 713 "default": "false" 714 }, 715 "target": { 716 "type": "string", 717 "description": "Dockerfile target name to build.", 718 "x-intellij-html-description": "Dockerfile target name to build." 719 } 720 }, 721 "preferredOrder": [ 722 "dockerfile", 723 "target", 724 "buildArgs", 725 "network", 726 "cacheFrom", 727 "noCache" 728 ], 729 "additionalProperties": false, 730 "type": "object", 731 "description": "*beta* describes an artifact built from a Dockerfile, usually using `docker build`.", 732 "x-intellij-html-description": "<em>beta</em> describes an artifact built from a Dockerfile, usually using <code>docker build</code>." 733 }, 734 "DockerConfig": { 735 "properties": { 736 "path": { 737 "type": "string", 738 "description": "path to the docker `config.json`.", 739 "x-intellij-html-description": "path to the docker <code>config.json</code>." 740 }, 741 "secretName": { 742 "type": "string", 743 "description": "Kubernetes secret that contains the `config.json` Docker configuration. Note that the expected secret type is not 'kubernetes.io/dockerconfigjson' but 'Opaque'.", 744 "x-intellij-html-description": "Kubernetes secret that contains the <code>config.json</code> Docker configuration. Note that the expected secret type is not 'kubernetes.io/dockerconfigjson' but 'Opaque'." 745 } 746 }, 747 "preferredOrder": [ 748 "path", 749 "secretName" 750 ], 751 "additionalProperties": false, 752 "type": "object", 753 "description": "contains information about the docker `config.json` to mount.", 754 "x-intellij-html-description": "contains information about the docker <code>config.json</code> to mount." 755 }, 756 "DockerfileDependency": { 757 "properties": { 758 "buildArgs": { 759 "additionalProperties": { 760 "type": "string" 761 }, 762 "type": "object", 763 "description": "arguments passed to the docker build. It also accepts environment variables via the go template syntax.", 764 "x-intellij-html-description": "arguments passed to the docker build. It also accepts environment variables via the go template syntax.", 765 "default": "{}", 766 "examples": [ 767 "{\"key1\": \"value1\", \"key2\": \"value2\", \"key3\": \"{{.ENV_VARIABLE}}\"}" 768 ] 769 }, 770 "path": { 771 "type": "string", 772 "description": "locates the Dockerfile relative to workspace.", 773 "x-intellij-html-description": "locates the Dockerfile relative to workspace." 774 } 775 }, 776 "preferredOrder": [ 777 "path", 778 "buildArgs" 779 ], 780 "additionalProperties": false, 781 "type": "object", 782 "description": "*alpha* used to specify a custom build artifact that is built from a Dockerfile. This allows skaffold to determine dependencies from the Dockerfile.", 783 "x-intellij-html-description": "<em>alpha</em> used to specify a custom build artifact that is built from a Dockerfile. This allows skaffold to determine dependencies from the Dockerfile." 784 }, 785 "EnvTemplateTagger": { 786 "required": [ 787 "template" 788 ], 789 "properties": { 790 "template": { 791 "type": "string", 792 "description": "used to produce the image name and tag. See golang [text/template](https://golang.org/pkg/text/template/). The template is executed against the current environment, with those variables injected: IMAGE_NAME | Name of the image being built, as supplied in the artifacts section.", 793 "x-intellij-html-description": "used to produce the image name and tag. See golang <a href=\"https://golang.org/pkg/text/template/\">text/template</a>. The template is executed against the current environment, with those variables injected: IMAGE_NAME | Name of the image being built, as supplied in the artifacts section.", 794 "examples": [ 795 "{{.RELEASE}}-{{.IMAGE_NAME}}" 796 ] 797 } 798 }, 799 "preferredOrder": [ 800 "template" 801 ], 802 "additionalProperties": false, 803 "type": "object", 804 "description": "*beta* tags images with a configurable template string.", 805 "x-intellij-html-description": "<em>beta</em> tags images with a configurable template string." 806 }, 807 "GitTagger": { 808 "properties": { 809 "variant": { 810 "type": "string", 811 "description": "determines the behavior of the git tagger. Valid variants are `Tags` (default): use git tags or fall back to abbreviated commit hash. `CommitSha`: use the full git commit sha. `AbbrevCommitSha`: use the abbreviated git commit sha. `TreeSha`: use the full tree hash of the artifact workingdir. `AbbrevTreeSha`: use the abbreviated tree hash of the artifact workingdir.", 812 "x-intellij-html-description": "determines the behavior of the git tagger. Valid variants are <code>Tags</code> (default): use git tags or fall back to abbreviated commit hash. <code>CommitSha</code>: use the full git commit sha. <code>AbbrevCommitSha</code>: use the abbreviated git commit sha. <code>TreeSha</code>: use the full tree hash of the artifact workingdir. <code>AbbrevTreeSha</code>: use the abbreviated tree hash of the artifact workingdir.", 813 "enum": [ 814 "Tags", 815 "CommitSha", 816 "AbbrevCommitSha", 817 "TreeSha", 818 "AbbrevTreeSha" 819 ] 820 } 821 }, 822 "preferredOrder": [ 823 "variant" 824 ], 825 "additionalProperties": false, 826 "type": "object", 827 "description": "*beta* tags images with the git tag or commit of the artifact's workspace.", 828 "x-intellij-html-description": "<em>beta</em> tags images with the git tag or commit of the artifact's workspace." 829 }, 830 "GoogleCloudBuild": { 831 "properties": { 832 "diskSizeGb": { 833 "type": "integer", 834 "description": "disk size of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).", 835 "x-intellij-html-description": "disk size of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>." 836 }, 837 "dockerImage": { 838 "type": "string", 839 "description": "image that runs a Docker build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).", 840 "x-intellij-html-description": "image that runs a Docker build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.", 841 "default": "gcr.io/cloud-builders/docker" 842 }, 843 "gradleImage": { 844 "type": "string", 845 "description": "image that runs a Gradle build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).", 846 "x-intellij-html-description": "image that runs a Gradle build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.", 847 "default": "gcr.io/cloud-builders/gradle" 848 }, 849 "machineType": { 850 "type": "string", 851 "description": "type of the VM that runs the build. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions).", 852 "x-intellij-html-description": "type of the VM that runs the build. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions\">Cloud Build Reference</a>." 853 }, 854 "mavenImage": { 855 "type": "string", 856 "description": "image that runs a Maven build. See [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders).", 857 "x-intellij-html-description": "image that runs a Maven build. See <a href=\"https://cloud.google.com/cloud-build/docs/cloud-builders\">Cloud Builders</a>.", 858 "default": "gcr.io/cloud-builders/mvn" 859 }, 860 "projectId": { 861 "type": "string", 862 "description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name `gcr.io/myproject/image`, Skaffold will use the `myproject` GCP project.", 863 "x-intellij-html-description": "ID of your Cloud Platform Project. If it is not provided, Skaffold will guess it from the image name. For example, given the artifact image name <code>gcr.io/myproject/image</code>, Skaffold will use the <code>myproject</code> GCP project." 864 }, 865 "timeout": { 866 "type": "string", 867 "description": "amount of time (in seconds) that this build should be allowed to run. See [Cloud Build Reference](https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build).", 868 "x-intellij-html-description": "amount of time (in seconds) that this build should be allowed to run. See <a href=\"https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#resource-build\">Cloud Build Reference</a>." 869 } 870 }, 871 "preferredOrder": [ 872 "projectId", 873 "diskSizeGb", 874 "machineType", 875 "timeout", 876 "dockerImage", 877 "mavenImage", 878 "gradleImage" 879 ], 880 "additionalProperties": false, 881 "type": "object", 882 "description": "*beta* describes how to do a remote build on [Google Cloud Build](https://cloud.google.com/cloud-build/docs/). Docker and Jib artifacts can be built on Cloud Build. The `projectId` needs to be provided and the currently logged in user should be given permissions to trigger new builds.", 883 "x-intellij-html-description": "<em>beta</em> describes how to do a remote build on <a href=\"https://cloud.google.com/cloud-build/docs/\">Google Cloud Build</a>. Docker and Jib artifacts can be built on Cloud Build. The <code>projectId</code> needs to be provided and the currently logged in user should be given permissions to trigger new builds." 884 }, 885 "HelmConventionConfig": { 886 "type": "object", 887 "description": "image config in the syntax of image.repository and image.tag.", 888 "x-intellij-html-description": "image config in the syntax of image.repository and image.tag." 889 }, 890 "HelmDeploy": { 891 "required": [ 892 "releases" 893 ], 894 "properties": { 895 "flags": { 896 "$ref": "#/definitions/HelmDeployFlags", 897 "description": "additional option flags that are passed on the command line to `helm`.", 898 "x-intellij-html-description": "additional option flags that are passed on the command line to <code>helm</code>." 899 }, 900 "releases": { 901 "items": { 902 "$ref": "#/definitions/HelmRelease" 903 }, 904 "type": "array", 905 "description": "a list of Helm releases.", 906 "x-intellij-html-description": "a list of Helm releases." 907 } 908 }, 909 "preferredOrder": [ 910 "releases", 911 "flags" 912 ], 913 "additionalProperties": false, 914 "type": "object", 915 "description": "*beta* uses the `helm` CLI to apply the charts to the cluster.", 916 "x-intellij-html-description": "<em>beta</em> uses the <code>helm</code> CLI to apply the charts to the cluster." 917 }, 918 "HelmDeployFlags": { 919 "properties": { 920 "global": { 921 "items": { 922 "type": "string" 923 }, 924 "type": "array", 925 "description": "additional flags passed on every command.", 926 "x-intellij-html-description": "additional flags passed on every command.", 927 "default": "[]" 928 }, 929 "install": { 930 "items": { 931 "type": "string" 932 }, 933 "type": "array", 934 "description": "additional flags passed to (`helm install`).", 935 "x-intellij-html-description": "additional flags passed to (<code>helm install</code>).", 936 "default": "[]" 937 }, 938 "upgrade": { 939 "items": { 940 "type": "string" 941 }, 942 "type": "array", 943 "description": "additional flags passed to (`helm upgrade`).", 944 "x-intellij-html-description": "additional flags passed to (<code>helm upgrade</code>).", 945 "default": "[]" 946 } 947 }, 948 "preferredOrder": [ 949 "global", 950 "install", 951 "upgrade" 952 ], 953 "additionalProperties": false, 954 "type": "object", 955 "description": "additional option flags that are passed on the command line to `helm`.", 956 "x-intellij-html-description": "additional option flags that are passed on the command line to <code>helm</code>." 957 }, 958 "HelmFQNConfig": { 959 "properties": { 960 "property": { 961 "type": "string", 962 "description": "defines the image config.", 963 "x-intellij-html-description": "defines the image config." 964 } 965 }, 966 "preferredOrder": [ 967 "property" 968 ], 969 "additionalProperties": false, 970 "type": "object", 971 "description": "image config to use the FullyQualifiedImageName as param to set.", 972 "x-intellij-html-description": "image config to use the FullyQualifiedImageName as param to set." 973 }, 974 "HelmImageStrategy": { 975 "type": "object", 976 "anyOf": [ 977 { 978 "additionalProperties": false 979 }, 980 { 981 "properties": { 982 "fqn": { 983 "$ref": "#/definitions/HelmFQNConfig", 984 "description": "image configuration uses the syntax `IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG`.", 985 "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME=IMAGE-REPOSITORY:IMAGE-TAG</code>." 986 } 987 }, 988 "preferredOrder": [ 989 "fqn" 990 ], 991 "additionalProperties": false 992 }, 993 { 994 "properties": { 995 "helm": { 996 "$ref": "#/definitions/HelmConventionConfig", 997 "description": "image configuration uses the syntax `IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG`.", 998 "x-intellij-html-description": "image configuration uses the syntax <code>IMAGE-NAME.repository=IMAGE-REPOSITORY, IMAGE-NAME.tag=IMAGE-TAG</code>." 999 } 1000 }, 1001 "preferredOrder": [ 1002 "helm" 1003 ], 1004 "additionalProperties": false 1005 } 1006 ], 1007 "description": "adds image configurations to the Helm `values` file.", 1008 "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file." 1009 }, 1010 "HelmPackaged": { 1011 "properties": { 1012 "appVersion": { 1013 "type": "string", 1014 "description": "sets the `appVersion` on the chart to this version.", 1015 "x-intellij-html-description": "sets the <code>appVersion</code> on the chart to this version." 1016 }, 1017 "version": { 1018 "type": "string", 1019 "description": "sets the `version` on the chart to this semver version.", 1020 "x-intellij-html-description": "sets the <code>version</code> on the chart to this semver version." 1021 } 1022 }, 1023 "preferredOrder": [ 1024 "version", 1025 "appVersion" 1026 ], 1027 "additionalProperties": false, 1028 "type": "object", 1029 "description": "parameters for packaging helm chart (`helm package`).", 1030 "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>)." 1031 }, 1032 "HelmRelease": { 1033 "required": [ 1034 "name", 1035 "chartPath" 1036 ], 1037 "properties": { 1038 "chartPath": { 1039 "type": "string", 1040 "description": "path to the Helm chart.", 1041 "x-intellij-html-description": "path to the Helm chart." 1042 }, 1043 "imageStrategy": { 1044 "$ref": "#/definitions/HelmImageStrategy", 1045 "description": "adds image configurations to the Helm `values` file.", 1046 "x-intellij-html-description": "adds image configurations to the Helm <code>values</code> file." 1047 }, 1048 "name": { 1049 "type": "string", 1050 "description": "name of the Helm release.", 1051 "x-intellij-html-description": "name of the Helm release." 1052 }, 1053 "namespace": { 1054 "type": "string", 1055 "description": "Kubernetes namespace.", 1056 "x-intellij-html-description": "Kubernetes namespace." 1057 }, 1058 "overrides": { 1059 "description": "key-value pairs. If present, Skaffold will build a Helm `values` file that overrides the original and use it to call Helm CLI (`--f` flag).", 1060 "x-intellij-html-description": "key-value pairs. If present, Skaffold will build a Helm <code>values</code> file that overrides the original and use it to call Helm CLI (<code>--f</code> flag)." 1061 }, 1062 "packaged": { 1063 "$ref": "#/definitions/HelmPackaged", 1064 "description": "parameters for packaging helm chart (`helm package`).", 1065 "x-intellij-html-description": "parameters for packaging helm chart (<code>helm package</code>)." 1066 }, 1067 "recreatePods": { 1068 "type": "boolean", 1069 "description": "if `true`, Skaffold will send `--recreate-pods` flag to Helm CLI.", 1070 "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--recreate-pods</code> flag to Helm CLI.", 1071 "default": "false" 1072 }, 1073 "remote": { 1074 "type": "boolean", 1075 "description": "specifies whether the chart path is remote, or exists on the host filesystem. `remote: true` implies `skipBuildDependencies: true`.", 1076 "x-intellij-html-description": "specifies whether the chart path is remote, or exists on the host filesystem. <code>remote: true</code> implies <code>skipBuildDependencies: true</code>.", 1077 "default": "false" 1078 }, 1079 "setValueTemplates": { 1080 "additionalProperties": { 1081 "type": "string" 1082 }, 1083 "type": "object", 1084 "description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send `--set` flag to Helm CLI and append all parsed pairs after the flag.", 1085 "x-intellij-html-description": "key-value pairs. If present, Skaffold will try to parse the value part of each key-value pair using environment variables in the system, then send <code>--set</code> flag to Helm CLI and append all parsed pairs after the flag.", 1086 "default": "{}" 1087 }, 1088 "setValues": { 1089 "additionalProperties": { 1090 "type": "string" 1091 }, 1092 "type": "object", 1093 "description": "key-value pairs. If present, Skaffold will send `--set` flag to Helm CLI and append all pairs after the flag.", 1094 "x-intellij-html-description": "key-value pairs. If present, Skaffold will send <code>--set</code> flag to Helm CLI and append all pairs after the flag.", 1095 "default": "{}" 1096 }, 1097 "skipBuildDependencies": { 1098 "type": "boolean", 1099 "description": "should build dependencies be skipped.", 1100 "x-intellij-html-description": "should build dependencies be skipped.", 1101 "default": "false" 1102 }, 1103 "useHelmSecrets": { 1104 "type": "boolean", 1105 "description": "instructs skaffold to use secrets plugin on deployment.", 1106 "x-intellij-html-description": "instructs skaffold to use secrets plugin on deployment.", 1107 "default": "false" 1108 }, 1109 "values": { 1110 "additionalProperties": { 1111 "type": "string" 1112 }, 1113 "type": "object", 1114 "description": "key-value pairs supplementing the Helm `values` file.", 1115 "x-intellij-html-description": "key-value pairs supplementing the Helm <code>values</code> file.", 1116 "default": "{}" 1117 }, 1118 "valuesFiles": { 1119 "items": { 1120 "type": "string" 1121 }, 1122 "type": "array", 1123 "description": "paths to the Helm `values` files.", 1124 "x-intellij-html-description": "paths to the Helm <code>values</code> files.", 1125 "default": "[]" 1126 }, 1127 "version": { 1128 "type": "string", 1129 "description": "version of the chart.", 1130 "x-intellij-html-description": "version of the chart." 1131 }, 1132 "wait": { 1133 "type": "boolean", 1134 "description": "if `true`, Skaffold will send `--wait` flag to Helm CLI.", 1135 "x-intellij-html-description": "if <code>true</code>, Skaffold will send <code>--wait</code> flag to Helm CLI.", 1136 "default": "false" 1137 } 1138 }, 1139 "preferredOrder": [ 1140 "name", 1141 "chartPath", 1142 "valuesFiles", 1143 "values", 1144 "namespace", 1145 "version", 1146 "setValues", 1147 "setValueTemplates", 1148 "wait", 1149 "recreatePods", 1150 "skipBuildDependencies", 1151 "useHelmSecrets", 1152 "remote", 1153 "overrides", 1154 "packaged", 1155 "imageStrategy" 1156 ], 1157 "additionalProperties": false, 1158 "type": "object", 1159 "description": "describes a helm release to be deployed.", 1160 "x-intellij-html-description": "describes a helm release to be deployed." 1161 }, 1162 "JSONPatch": { 1163 "required": [ 1164 "path" 1165 ], 1166 "properties": { 1167 "from": { 1168 "type": "string", 1169 "description": "source position in the yaml, used for `copy` or `move` operations.", 1170 "x-intellij-html-description": "source position in the yaml, used for <code>copy</code> or <code>move</code> operations." 1171 }, 1172 "op": { 1173 "type": "string", 1174 "description": "operation carried by the patch: `add`, `remove`, `replace`, `move`, `copy` or `test`.", 1175 "x-intellij-html-description": "operation carried by the patch: <code>add</code>, <code>remove</code>, <code>replace</code>, <code>move</code>, <code>copy</code> or <code>test</code>.", 1176 "default": "replace" 1177 }, 1178 "path": { 1179 "type": "string", 1180 "description": "position in the yaml where the operation takes place. For example, this targets the `dockerfile` of the first artifact built.", 1181 "x-intellij-html-description": "position in the yaml where the operation takes place. For example, this targets the <code>dockerfile</code> of the first artifact built.", 1182 "examples": [ 1183 "/build/artifacts/0/docker/dockerfile" 1184 ] 1185 }, 1186 "value": { 1187 "description": "value to apply. Can be any portion of yaml.", 1188 "x-intellij-html-description": "value to apply. Can be any portion of yaml." 1189 } 1190 }, 1191 "preferredOrder": [ 1192 "op", 1193 "path", 1194 "from", 1195 "value" 1196 ], 1197 "additionalProperties": false, 1198 "type": "object", 1199 "description": "patch to be applied by a profile.", 1200 "x-intellij-html-description": "patch to be applied by a profile." 1201 }, 1202 "JibGradleArtifact": { 1203 "properties": { 1204 "args": { 1205 "items": { 1206 "type": "string" 1207 }, 1208 "type": "array", 1209 "description": "additional build flags passed to Gradle.", 1210 "x-intellij-html-description": "additional build flags passed to Gradle.", 1211 "default": "[]", 1212 "examples": [ 1213 "[\"--no-build-cache\"]" 1214 ] 1215 }, 1216 "project": { 1217 "type": "string", 1218 "description": "selects which Gradle project to build.", 1219 "x-intellij-html-description": "selects which Gradle project to build." 1220 } 1221 }, 1222 "preferredOrder": [ 1223 "project", 1224 "args" 1225 ], 1226 "additionalProperties": false, 1227 "type": "object", 1228 "description": "*alpha* builds images using the [Jib plugin for Gradle](https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin).", 1229 "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-gradle-plugin\">Jib plugin for Gradle</a>." 1230 }, 1231 "JibMavenArtifact": { 1232 "properties": { 1233 "args": { 1234 "items": { 1235 "type": "string" 1236 }, 1237 "type": "array", 1238 "description": "additional build flags passed to Maven.", 1239 "x-intellij-html-description": "additional build flags passed to Maven.", 1240 "default": "[]", 1241 "examples": [ 1242 "[\"-x\", \"-DskipTests\"]" 1243 ] 1244 }, 1245 "module": { 1246 "type": "string", 1247 "description": "selects which Maven module to build, for a multi module project.", 1248 "x-intellij-html-description": "selects which Maven module to build, for a multi module project." 1249 }, 1250 "profile": { 1251 "type": "string", 1252 "description": "selects which Maven profile to activate.", 1253 "x-intellij-html-description": "selects which Maven profile to activate." 1254 } 1255 }, 1256 "preferredOrder": [ 1257 "module", 1258 "profile", 1259 "args" 1260 ], 1261 "additionalProperties": false, 1262 "type": "object", 1263 "description": "*alpha* builds images using the [Jib plugin for Maven](https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin).", 1264 "x-intellij-html-description": "<em>alpha</em> builds images using the <a href=\"https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin\">Jib plugin for Maven</a>." 1265 }, 1266 "KanikoArtifact": { 1267 "properties": { 1268 "buildArgs": { 1269 "additionalProperties": { 1270 "type": "string" 1271 }, 1272 "type": "object", 1273 "description": "arguments passed to the docker build. It also accepts environment variables via the go template syntax.", 1274 "x-intellij-html-description": "arguments passed to the docker build. It also accepts environment variables via the go template syntax.", 1275 "default": "{}", 1276 "examples": [ 1277 "{\"key1\": \"value1\", \"key2\": \"value2\", \"key3\": \"{{.ENV_VARIABLE}}\"}" 1278 ] 1279 }, 1280 "buildContext": { 1281 "$ref": "#/definitions/KanikoBuildContext", 1282 "description": "where the build context for this artifact resides.", 1283 "x-intellij-html-description": "where the build context for this artifact resides." 1284 }, 1285 "cache": { 1286 "$ref": "#/definitions/KanikoCache", 1287 "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.", 1288 "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds." 1289 }, 1290 "dockerfile": { 1291 "type": "string", 1292 "description": "locates the Dockerfile relative to workspace.", 1293 "x-intellij-html-description": "locates the Dockerfile relative to workspace.", 1294 "default": "Dockerfile" 1295 }, 1296 "flags": { 1297 "items": { 1298 "type": "string" 1299 }, 1300 "type": "array", 1301 "description": "additional flags to be passed to Kaniko command line. See [Kaniko Additional Flags](https://github.com/GoogleContainerTools/kaniko#additional-flags). Deprecated - instead the named, unique fields should be used, e.g. `buildArgs`, `cache`, `target`.", 1302 "x-intellij-html-description": "additional flags to be passed to Kaniko command line. See <a href=\"https://github.com/GoogleContainerTools/kaniko#additional-flags\">Kaniko Additional Flags</a>. Deprecated - instead the named, unique fields should be used, e.g. <code>buildArgs</code>, <code>cache</code>, <code>target</code>.", 1303 "default": "[]" 1304 }, 1305 "image": { 1306 "type": "string", 1307 "description": "Docker image used by the Kaniko pod. Defaults to the latest released version of `gcr.io/kaniko-project/executor`.", 1308 "x-intellij-html-description": "Docker image used by the Kaniko pod. Defaults to the latest released version of <code>gcr.io/kaniko-project/executor</code>." 1309 }, 1310 "target": { 1311 "type": "string", 1312 "description": "Dockerfile target name to build.", 1313 "x-intellij-html-description": "Dockerfile target name to build." 1314 } 1315 }, 1316 "preferredOrder": [ 1317 "flags", 1318 "dockerfile", 1319 "target", 1320 "buildArgs", 1321 "buildContext", 1322 "image", 1323 "cache" 1324 ], 1325 "additionalProperties": false, 1326 "type": "object", 1327 "description": "*alpha* describes an artifact built from a Dockerfile, with kaniko.", 1328 "x-intellij-html-description": "<em>alpha</em> describes an artifact built from a Dockerfile, with kaniko." 1329 }, 1330 "KanikoBuildContext": { 1331 "properties": { 1332 "gcsBucket": { 1333 "type": "string", 1334 "description": "GCS bucket to which sources are uploaded. Kaniko will need access to that bucket to download the sources.", 1335 "x-intellij-html-description": "GCS bucket to which sources are uploaded. Kaniko will need access to that bucket to download the sources." 1336 }, 1337 "localDir": { 1338 "$ref": "#/definitions/LocalDir", 1339 "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.", 1340 "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume." 1341 } 1342 }, 1343 "preferredOrder": [ 1344 "gcsBucket", 1345 "localDir" 1346 ], 1347 "additionalProperties": false, 1348 "type": "object", 1349 "description": "contains the different fields available to specify a Kaniko build context.", 1350 "x-intellij-html-description": "contains the different fields available to specify a Kaniko build context." 1351 }, 1352 "KanikoCache": { 1353 "properties": { 1354 "hostPath": { 1355 "type": "string", 1356 "description": "specifies a path on the host that is mounted to each pod as read only cache volume containing base images. If set, must exist on each node and prepopulated with kaniko-warmer.", 1357 "x-intellij-html-description": "specifies a path on the host that is mounted to each pod as read only cache volume containing base images. If set, must exist on each node and prepopulated with kaniko-warmer." 1358 }, 1359 "repo": { 1360 "type": "string", 1361 "description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See [Kaniko Caching](https://github.com/GoogleContainerTools/kaniko#caching).", 1362 "x-intellij-html-description": "a remote repository to store cached layers. If none is specified, one will be inferred from the image name. See <a href=\"https://github.com/GoogleContainerTools/kaniko#caching\">Kaniko Caching</a>." 1363 } 1364 }, 1365 "preferredOrder": [ 1366 "repo", 1367 "hostPath" 1368 ], 1369 "additionalProperties": false, 1370 "type": "object", 1371 "description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds.", 1372 "x-intellij-html-description": "configures Kaniko caching. If a cache is specified, Kaniko will use a remote cache which will speed up builds." 1373 }, 1374 "KubectlDeploy": { 1375 "properties": { 1376 "flags": { 1377 "$ref": "#/definitions/KubectlFlags", 1378 "description": "additional flags passed to `kubectl`.", 1379 "x-intellij-html-description": "additional flags passed to <code>kubectl</code>." 1380 }, 1381 "manifests": { 1382 "items": { 1383 "type": "string" 1384 }, 1385 "type": "array", 1386 "description": "the Kubernetes yaml or json manifests.", 1387 "x-intellij-html-description": "the Kubernetes yaml or json manifests.", 1388 "default": "[\"k8s/*.yaml\"]" 1389 }, 1390 "remoteManifests": { 1391 "items": { 1392 "type": "string" 1393 }, 1394 "type": "array", 1395 "description": "Kubernetes manifests in remote clusters.", 1396 "x-intellij-html-description": "Kubernetes manifests in remote clusters.", 1397 "default": "[]" 1398 } 1399 }, 1400 "preferredOrder": [ 1401 "manifests", 1402 "remoteManifests", 1403 "flags" 1404 ], 1405 "additionalProperties": false, 1406 "type": "object", 1407 "description": "*beta* uses a client side `kubectl apply` to deploy manifests. You'll need a `kubectl` CLI version installed that's compatible with your cluster.", 1408 "x-intellij-html-description": "<em>beta</em> uses a client side <code>kubectl apply</code> to deploy manifests. You'll need a <code>kubectl</code> CLI version installed that's compatible with your cluster." 1409 }, 1410 "KubectlFlags": { 1411 "properties": { 1412 "apply": { 1413 "items": { 1414 "type": "string" 1415 }, 1416 "type": "array", 1417 "description": "additional flags passed on creations (`kubectl apply`).", 1418 "x-intellij-html-description": "additional flags passed on creations (<code>kubectl apply</code>).", 1419 "default": "[]" 1420 }, 1421 "delete": { 1422 "items": { 1423 "type": "string" 1424 }, 1425 "type": "array", 1426 "description": "additional flags passed on deletions (`kubectl delete`).", 1427 "x-intellij-html-description": "additional flags passed on deletions (<code>kubectl delete</code>).", 1428 "default": "[]" 1429 }, 1430 "global": { 1431 "items": { 1432 "type": "string" 1433 }, 1434 "type": "array", 1435 "description": "additional flags passed on every command.", 1436 "x-intellij-html-description": "additional flags passed on every command.", 1437 "default": "[]" 1438 } 1439 }, 1440 "preferredOrder": [ 1441 "global", 1442 "apply", 1443 "delete" 1444 ], 1445 "additionalProperties": false, 1446 "type": "object", 1447 "description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete).", 1448 "x-intellij-html-description": "additional flags passed on the command line to kubectl either on every command (Global), on creations (Apply) or deletions (Delete)." 1449 }, 1450 "KustomizeDeploy": { 1451 "properties": { 1452 "flags": { 1453 "$ref": "#/definitions/KubectlFlags", 1454 "description": "additional flags passed to `kubectl`.", 1455 "x-intellij-html-description": "additional flags passed to <code>kubectl</code>." 1456 }, 1457 "path": { 1458 "type": "string", 1459 "description": "path to Kustomization files.", 1460 "x-intellij-html-description": "path to Kustomization files.", 1461 "default": "." 1462 } 1463 }, 1464 "preferredOrder": [ 1465 "path", 1466 "flags" 1467 ], 1468 "additionalProperties": false, 1469 "type": "object", 1470 "description": "*beta* uses the `kustomize` CLI to \"patch\" a deployment for a target environment.", 1471 "x-intellij-html-description": "<em>beta</em> uses the <code>kustomize</code> CLI to "patch" a deployment for a target environment." 1472 }, 1473 "LocalBuild": { 1474 "properties": { 1475 "push": { 1476 "type": "boolean", 1477 "description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster.", 1478 "x-intellij-html-description": "should images be pushed to a registry. If not specified, images are pushed only if the current Kubernetes context connects to a remote cluster." 1479 }, 1480 "useBuildkit": { 1481 "type": "boolean", 1482 "description": "use BuildKit to build Docker images. If unspecified, uses the Docker default.", 1483 "x-intellij-html-description": "use BuildKit to build Docker images. If unspecified, uses the Docker default." 1484 }, 1485 "useDockerCLI": { 1486 "type": "boolean", 1487 "description": "use `docker` command-line interface instead of Docker Engine APIs.", 1488 "x-intellij-html-description": "use <code>docker</code> command-line interface instead of Docker Engine APIs.", 1489 "default": "false" 1490 } 1491 }, 1492 "preferredOrder": [ 1493 "push", 1494 "useDockerCLI", 1495 "useBuildkit" 1496 ], 1497 "additionalProperties": false, 1498 "type": "object", 1499 "description": "*beta* describes how to do a build on the local docker daemon and optionally push to a repository.", 1500 "x-intellij-html-description": "<em>beta</em> describes how to do a build on the local docker daemon and optionally push to a repository." 1501 }, 1502 "LocalDir": { 1503 "properties": { 1504 "initImage": { 1505 "type": "string", 1506 "description": "image used to run init container which mounts kaniko context.", 1507 "x-intellij-html-description": "image used to run init container which mounts kaniko context." 1508 } 1509 }, 1510 "preferredOrder": [ 1511 "initImage" 1512 ], 1513 "additionalProperties": false, 1514 "type": "object", 1515 "description": "configures how Kaniko mounts sources directly via an `emptyDir` volume.", 1516 "x-intellij-html-description": "configures how Kaniko mounts sources directly via an <code>emptyDir</code> volume." 1517 }, 1518 "Profile": { 1519 "required": [ 1520 "name" 1521 ], 1522 "properties": { 1523 "activation": { 1524 "items": { 1525 "$ref": "#/definitions/Activation" 1526 }, 1527 "type": "array", 1528 "description": "criteria by which a profile can be auto-activated. The profile is auto-activated if any one of the activations are triggered. An activation is triggered if all of the criteria (env, kubeContext, command) are triggered.", 1529 "x-intellij-html-description": "criteria by which a profile can be auto-activated. The profile is auto-activated if any one of the activations are triggered. An activation is triggered if all of the criteria (env, kubeContext, command) are triggered." 1530 }, 1531 "build": { 1532 "$ref": "#/definitions/BuildConfig", 1533 "description": "describes how images are built.", 1534 "x-intellij-html-description": "describes how images are built." 1535 }, 1536 "deploy": { 1537 "$ref": "#/definitions/DeployConfig", 1538 "description": "describes how images are deployed.", 1539 "x-intellij-html-description": "describes how images are deployed." 1540 }, 1541 "name": { 1542 "type": "string", 1543 "description": "a unique profile name.", 1544 "x-intellij-html-description": "a unique profile name.", 1545 "examples": [ 1546 "profile-prod" 1547 ] 1548 }, 1549 "patches": { 1550 "items": { 1551 "$ref": "#/definitions/JSONPatch" 1552 }, 1553 "type": "array", 1554 "description": "patches applied to the configuration. Patches use the JSON patch notation.", 1555 "x-intellij-html-description": "patches applied to the configuration. Patches use the JSON patch notation." 1556 }, 1557 "test": { 1558 "items": { 1559 "$ref": "#/definitions/TestCase" 1560 }, 1561 "type": "array", 1562 "description": "describes how images are tested.", 1563 "x-intellij-html-description": "describes how images are tested." 1564 } 1565 }, 1566 "preferredOrder": [ 1567 "name", 1568 "build", 1569 "test", 1570 "deploy", 1571 "patches", 1572 "activation" 1573 ], 1574 "additionalProperties": false, 1575 "type": "object", 1576 "description": "*beta* profiles are used to override any `build`, `test` or `deploy` configuration.", 1577 "x-intellij-html-description": "<em>beta</em> profiles are used to override any <code>build</code>, <code>test</code> or <code>deploy</code> configuration." 1578 }, 1579 "ResourceRequirement": { 1580 "properties": { 1581 "cpu": { 1582 "type": "string", 1583 "description": "the number cores to be used.", 1584 "x-intellij-html-description": "the number cores to be used.", 1585 "examples": [ 1586 "2`, `2.0` or `200m" 1587 ] 1588 }, 1589 "memory": { 1590 "type": "string", 1591 "description": "the amount of memory to allocate to the pod.", 1592 "x-intellij-html-description": "the amount of memory to allocate to the pod.", 1593 "examples": [ 1594 "1Gi` or `1000Mi" 1595 ] 1596 } 1597 }, 1598 "preferredOrder": [ 1599 "cpu", 1600 "memory" 1601 ], 1602 "additionalProperties": false, 1603 "type": "object", 1604 "description": "stores the CPU/Memory requirements for the pod.", 1605 "x-intellij-html-description": "stores the CPU/Memory requirements for the pod." 1606 }, 1607 "ResourceRequirements": { 1608 "properties": { 1609 "limits": { 1610 "$ref": "#/definitions/ResourceRequirement", 1611 "description": "[resource limits](https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/#resource-requests-and-limits-of-pod-and-container) for the Kaniko pod.", 1612 "x-intellij-html-description": "<a href=\"https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/#resource-requests-and-limits-of-pod-and-container\">resource limits</a> for the Kaniko pod." 1613 }, 1614 "requests": { 1615 "$ref": "#/definitions/ResourceRequirement", 1616 "description": "[resource requests](https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/#resource-requests-and-limits-of-pod-and-container) for the Kaniko pod.", 1617 "x-intellij-html-description": "<a href=\"https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/#resource-requests-and-limits-of-pod-and-container\">resource requests</a> for the Kaniko pod." 1618 } 1619 }, 1620 "preferredOrder": [ 1621 "requests", 1622 "limits" 1623 ], 1624 "additionalProperties": false, 1625 "type": "object", 1626 "description": "describes the resource requirements for the kaniko pod.", 1627 "x-intellij-html-description": "describes the resource requirements for the kaniko pod." 1628 }, 1629 "ShaTagger": { 1630 "type": "object", 1631 "description": "*beta* tags images with their sha256 digest.", 1632 "x-intellij-html-description": "<em>beta</em> tags images with their sha256 digest." 1633 }, 1634 "SkaffoldConfig": { 1635 "required": [ 1636 "apiVersion", 1637 "kind" 1638 ], 1639 "properties": { 1640 "apiVersion": { 1641 "type": "string", 1642 "description": "version of the configuration.", 1643 "x-intellij-html-description": "version of the configuration." 1644 }, 1645 "build": { 1646 "$ref": "#/definitions/BuildConfig", 1647 "description": "describes how images are built.", 1648 "x-intellij-html-description": "describes how images are built." 1649 }, 1650 "deploy": { 1651 "$ref": "#/definitions/DeployConfig", 1652 "description": "describes how images are deployed.", 1653 "x-intellij-html-description": "describes how images are deployed." 1654 }, 1655 "kind": { 1656 "type": "string", 1657 "description": "always `Config`.", 1658 "x-intellij-html-description": "always <code>Config</code>.", 1659 "default": "Config" 1660 }, 1661 "profiles": { 1662 "items": { 1663 "$ref": "#/definitions/Profile" 1664 }, 1665 "type": "array", 1666 "description": "*beta* can override be used to `build`, `test` or `deploy` configuration.", 1667 "x-intellij-html-description": "<em>beta</em> can override be used to <code>build</code>, <code>test</code> or <code>deploy</code> configuration." 1668 }, 1669 "test": { 1670 "items": { 1671 "$ref": "#/definitions/TestCase" 1672 }, 1673 "type": "array", 1674 "description": "describes how images are tested.", 1675 "x-intellij-html-description": "describes how images are tested." 1676 } 1677 }, 1678 "preferredOrder": [ 1679 "apiVersion", 1680 "kind", 1681 "build", 1682 "test", 1683 "deploy", 1684 "profiles" 1685 ], 1686 "additionalProperties": false, 1687 "type": "object", 1688 "description": "holds the fields parsed from the Skaffold configuration file (skaffold.yaml).", 1689 "x-intellij-html-description": "holds the fields parsed from the Skaffold configuration file (skaffold.yaml)." 1690 }, 1691 "Sync": { 1692 "properties": { 1693 "manual": { 1694 "items": { 1695 "$ref": "#/definitions/SyncRule" 1696 }, 1697 "type": "array", 1698 "description": "manual sync rules indicating the source and destination.", 1699 "x-intellij-html-description": "manual sync rules indicating the source and destination." 1700 } 1701 }, 1702 "preferredOrder": [ 1703 "manual" 1704 ], 1705 "additionalProperties": false, 1706 "type": "object", 1707 "description": "*alpha* specifies what files to sync into the container. This is a list of sync rules indicating the intent to sync for source files.", 1708 "x-intellij-html-description": "<em>alpha</em> specifies what files to sync into the container. This is a list of sync rules indicating the intent to sync for source files." 1709 }, 1710 "SyncRule": { 1711 "required": [ 1712 "src", 1713 "dest" 1714 ], 1715 "properties": { 1716 "dest": { 1717 "type": "string", 1718 "description": "destination path in the container where the files should be synced to.", 1719 "x-intellij-html-description": "destination path in the container where the files should be synced to.", 1720 "examples": [ 1721 "\"app/\"" 1722 ] 1723 }, 1724 "src": { 1725 "type": "string", 1726 "description": "a glob pattern to match local paths against. Directories should be delimited by `/` on all platforms.", 1727 "x-intellij-html-description": "a glob pattern to match local paths against. Directories should be delimited by <code>/</code> on all platforms.", 1728 "examples": [ 1729 "\"css/**/*.css\"" 1730 ] 1731 }, 1732 "strip": { 1733 "type": "string", 1734 "description": "specifies the path prefix to remove from the source path when transplanting the files into the destination folder.", 1735 "x-intellij-html-description": "specifies the path prefix to remove from the source path when transplanting the files into the destination folder.", 1736 "examples": [ 1737 "\"css/\"" 1738 ] 1739 } 1740 }, 1741 "preferredOrder": [ 1742 "src", 1743 "dest", 1744 "strip" 1745 ], 1746 "additionalProperties": false, 1747 "type": "object", 1748 "description": "specifies which local files to sync to remote folders.", 1749 "x-intellij-html-description": "specifies which local files to sync to remote folders." 1750 }, 1751 "TagPolicy": { 1752 "properties": { 1753 "dateTime": { 1754 "$ref": "#/definitions/DateTimeTagger", 1755 "description": "*beta* tags images with the build timestamp.", 1756 "x-intellij-html-description": "<em>beta</em> tags images with the build timestamp." 1757 }, 1758 "envTemplate": { 1759 "$ref": "#/definitions/EnvTemplateTagger", 1760 "description": "*beta* tags images with a configurable template string.", 1761 "x-intellij-html-description": "<em>beta</em> tags images with a configurable template string." 1762 }, 1763 "gitCommit": { 1764 "$ref": "#/definitions/GitTagger", 1765 "description": "*beta* tags images with the git tag or commit of the artifact's workspace.", 1766 "x-intellij-html-description": "<em>beta</em> tags images with the git tag or commit of the artifact's workspace." 1767 }, 1768 "sha256": { 1769 "$ref": "#/definitions/ShaTagger", 1770 "description": "*beta* tags images with their sha256 digest.", 1771 "x-intellij-html-description": "<em>beta</em> tags images with their sha256 digest." 1772 } 1773 }, 1774 "preferredOrder": [ 1775 "gitCommit", 1776 "sha256", 1777 "envTemplate", 1778 "dateTime" 1779 ], 1780 "additionalProperties": false, 1781 "type": "object", 1782 "description": "contains all the configuration for the tagging step.", 1783 "x-intellij-html-description": "contains all the configuration for the tagging step." 1784 }, 1785 "TestCase": { 1786 "required": [ 1787 "image" 1788 ], 1789 "properties": { 1790 "image": { 1791 "type": "string", 1792 "description": "artifact on which to run those tests.", 1793 "x-intellij-html-description": "artifact on which to run those tests.", 1794 "examples": [ 1795 "gcr.io/k8s-skaffold/example" 1796 ] 1797 }, 1798 "structureTests": { 1799 "items": { 1800 "type": "string" 1801 }, 1802 "type": "array", 1803 "description": "the [Container Structure Tests](https://github.com/GoogleContainerTools/container-structure-test) to run on that artifact.", 1804 "x-intellij-html-description": "the <a href=\"https://github.com/GoogleContainerTools/container-structure-test\">Container Structure Tests</a> to run on that artifact.", 1805 "default": "[]", 1806 "examples": [ 1807 "[\"./test/*\"]" 1808 ] 1809 } 1810 }, 1811 "preferredOrder": [ 1812 "image", 1813 "structureTests" 1814 ], 1815 "additionalProperties": false, 1816 "type": "object", 1817 "description": "a list of structure tests to run on images that Skaffold builds.", 1818 "x-intellij-html-description": "a list of structure tests to run on images that Skaffold builds." 1819 } 1820 } 1821 }