Skip to content

Commit dcdf7c1

Browse files
docs: minor edits to Cloud Build docs (#8571)
1 parent 109fe4e commit dcdf7c1

File tree

1 file changed

+24
-18
lines changed

1 file changed

+24
-18
lines changed

docs-v2/content/en/docs/builders/build-environments/cloud-build.md

Lines changed: 24 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -6,22 +6,27 @@ weight: 30
66

77
Skaffold supports building remotely with Google Cloud Build.
88

9-
[Google Cloud Build](https://cloud.google.com/cloud-build/) is a
9+
[Cloud Build](https://cloud.google.com/cloud-build/) is a
1010
[Google Cloud Platform](https://cloud.google.com) service that executes
11-
your builds using Google infrastructure. To get started with Google
11+
your builds using Google infrastructure. To get started with Cloud
1212
Build, see [Cloud Build Quickstart](https://cloud.google.com/cloud-build/docs/quickstart-docker).
1313

14-
Skaffold can automatically connect to Cloud Build, and run your builds
15-
with it. After Cloud Build finishes building your artifacts, they will
16-
be saved to the specified remote registry, such as
14+
Skaffold automatically connects to Cloud Build and runs your builds
15+
with it. After Cloud Build finishes building your artifacts, they are
16+
saved to the specified remote registry, such as
1717
[Google Container Registry](https://cloud.google.com/container-registry/).
1818

19-
Skaffold Google Cloud Build process differs from the gcloud command
20-
`gcloud builds submit`. Skaffold will create a list of dependent files
21-
and submit a tar file to GCB. It will then generate a single step `cloudbuild.yaml`
22-
and will start the building process. Skaffold does not honor `.gitignore` or `.gcloudignore`
23-
exclusions. If you need to ignore files use `.dockerignore`. Any `cloudbuild.yaml` found will not
24-
be used in the build process.
19+
Skaffold's Cloud Build process differs from the gcloud command
20+
[`gcloud builds submit`](https://cloud.google.com/sdk/gcloud/reference/builds/submit).
21+
Skaffold does the following:
22+
* Creates a list of dependent files
23+
* Uploads a tar file of the dependent files to Google Cloud Storage
24+
* Submits the tar file to Cloud Build
25+
* Generates a single-step `cloudbuild.yaml`
26+
* Starts the build
27+
28+
Skaffold does not honor `.gitignore` or `.gcloudignore` exclusions. If you need to ignore files, use `.dockerignore`.
29+
Any `cloudbuild.yaml` found will not be used in the build process.
2530

2631
## Configuration
2732

@@ -39,16 +44,17 @@ The following options can optionally be configured:
3944
4045
## Faster builds
4146
42-
Skaffold can build multiple artifacts in parallel, by settings a value higher than `1` to `concurrency`.
43-
For Google Cloud Build, the default is to build all the artifacts in parallel. If you hit a quota restriction,
44-
you might want to reduce the `concurrency`.
47+
By default, Cloud Build (invoked by Skaffold) builds all artifacts in parallel. Set `concurrency` to a non-zero
48+
value to specify the maximum number of artifacts to build concurrently. Consider reducing `concurrency` if you
49+
hit a quota restriction.
4550

4651
{{<alert title="Note">}}
47-
When artifacts are built in parallel, the build logs are still printed in sequence to make them easier to read.
52+
When Skaffold builds artifacts in parallel, it still prints the build logs in sequence to make them easier to read.
4853
{{</alert>}}
4954

5055
## Restrictions
5156

52-
Skaffold currently supports [Docker]({{<relref "/docs/builders/builder-types/docker#dockerfile-remotely-with-google-cloud-build">}}),
53-
[Jib]({{<relref "/docs/builders/builder-types/jib#remotely-with-google-cloud-build">}})
54-
on Google Cloud Build.
57+
Skaffold currently supports the following [builder types]({{<relref "/docs/builders/builder-types">}})
58+
when building remotely with Cloud Build:
59+
* [Docker]({{<relref "/docs/builders/builder-types/docker#dockerfile-remotely-with-google-cloud-build">}})
60+
* [Jib]({{<relref "/docs/builders/builder-types/jib#remotely-with-google-cloud-build">}})

0 commit comments

Comments
 (0)