Skip to content

Commit ded5e89

Browse files
scotthartscotthart
authored
doc: set gcloud project once in config (#418)
1 parent 2e3d900 commit ded5e89

File tree

6 files changed

+42
-40
lines changed

6 files changed

+42
-40
lines changed

‎ci/README.md‎

Lines changed: 10 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,14 @@ the name of the project you want to use.
2727

2828
## Enable the Services
2929

30+
Set the active project:
31+
32+
```sh
33+
gcloud config set project ${GOOGLE_CLOUD_PROJECT}
34+
```
35+
3036
```sh
31-
gcloud services enable --project="${GOOGLE_CLOUD_PROJECT}" \
37+
gcloud services enable \
3238
bigtable.googleapis.com \
3339
cloudbuild.googleapis.com \
3440
cloudfunctions.googleapis.com \
@@ -44,10 +50,8 @@ gcloud services enable --project="${GOOGLE_CLOUD_PROJECT}" \
4450
## Create Pub/Sub Topics
4551

4652
```sh
47-
gcloud pubsub topics create testing \
48-
--project="${GOOGLE_CLOUD_PROJECT}"
49-
gcloud pubsub topics create gcs-changes \
50-
--project="${GOOGLE_CLOUD_PROJECT}"
53+
gcloud pubsub topics create testing
54+
gcloud pubsub topics create gcs-changes
5155
```
5256

5357
## Create a Bucket
@@ -77,7 +81,6 @@ Add this service account to the topic:Grant the
7781

7882
```shell
7983
gcloud pubsub topics add-iam-policy-binding \
80-
--project="${GOOGLE_CLOUD_PROJECT}" \
8184
--role="roles/pubsub.publisher" \
8285
--member="serviceAccount:${GCS_SA}" \
8386
gcs-changes
@@ -98,7 +101,6 @@ readonly SA_ID="eventarc-trigger-sa"
98101
readonly SA_NAME="${SA_ID}@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com"
99102

100103
gcloud iam service-accounts create "${SA_ID}" \
101-
"--project=${GOOGLE_CLOUD_PROJECT}" \
102104
--description="Event Arg Triggers"
103105
```
104106

@@ -158,7 +160,6 @@ Create a Cloud Run deployment running the hello world example:
158160

159161
```sh
160162
gcloud run deploy gcf-hello-world-http \
161-
--project="${GOOGLE_CLOUD_PROJECT}" \
162163
--image="gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-hello-world-http:latest" \
163164
--region="us-central1" \
164165
--platform="managed" \
@@ -169,7 +170,6 @@ Test it by sending a request with `curl(1)`:
169170

170171
```sh
171172
HTTP_SERVICE_URL=$(gcloud run services describe \
172-
--project="${GOOGLE_CLOUD_PROJECT}" \
173173
--platform="managed" \
174174
--region="us-central1" \
175175
--format="value(status.url)" \
@@ -185,7 +185,6 @@ triggers:
185185

186186
```sh
187187
gcloud run deploy gcf-hello-world-pubsub \
188-
--project="${GOOGLE_CLOUD_PROJECT}" \
189188
--image="gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-hello-world-pubsub:latest" \
190189
--region="us-central1" \
191190
--platform="managed" \
@@ -199,7 +198,6 @@ PROJECT_NUMBER="$(gcloud projects list \
199198
--filter="PROJECT_ID=${GOOGLE_CLOUD_PROJECT}" \
200199
--format="value(project_number)")"
201200
gcloud beta eventarc triggers create gcf-hello-world-pubsub-trigger \
202-
--project="${GOOGLE_CLOUD_PROJECT}" \
203201
--location="us-central1" \
204202
--destination-run-service="gcf-hello-world-pubsub" \
205203
--destination-run-region="us-central1" \
@@ -210,7 +208,6 @@ Test by sending a message to the right topic:
210208

211209
```sh
212210
TOPIC=$(gcloud beta eventarc triggers describe gcf-hello-world-pubsub-trigger \
213-
--project="${GOOGLE_CLOUD_PROJECT}" \
214211
--location="us-central1" \
215212
--format="value(transport.pubsub.topic)")
216213
NONCE=$(date +%s)-${RANDOM}
@@ -221,7 +218,6 @@ And then verify this message shows up in the log:
221218

222219
```sh
223220
gcloud logging read \
224-
--project="${GOOGLE_CLOUD_PROJECT}" \
225221
--format="value(textPayload)" \
226222
"resource.type=cloud_run_revision AND resource.labels.service_name=gcf-hello-world-pubsub AND logName:stdout"
227223
```
@@ -233,7 +229,6 @@ triggers:
233229

234230
```sh
235231
gcloud run deploy gcf-hello-world-storage \
236-
--project="${GOOGLE_CLOUD_PROJECT}" \
237232
--image="gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-hello-world-storage:latest" \
238233
--region="us-central1" \
239234
--platform="managed" \
@@ -244,7 +239,6 @@ Create a trigger for Cloud Storage events:
244239

245240
```sh
246241
gcloud beta eventarc triggers create gcf-hello-world-storage-trigger \
247-
--project="${GOOGLE_CLOUD_PROJECT}" \
248242
--location="us-central1" \
249243
--destination-run-service="gcf-hello-world-storage" \
250244
--destination-run-region="us-central1" \
@@ -257,7 +251,6 @@ And then verify this message shows up in the log:
257251

258252
```sh
259253
gcloud logging read \
260-
--project="${GOOGLE_CLOUD_PROJECT}" \
261254
--format="value(textPayload)" \
262255
"resource.type=cloud_run_revision AND resource.labels.service_name=gcf-hello-world-storage AND logName:stdout"
263256
```
@@ -268,7 +261,6 @@ Finally verify this works by running the Cloud Build:
268261

269262
```sh
270263
gcloud builds submit \
271-
"--project=${GOOGLE_CLOUD_PROJECT}" \
272264
"--substitutions=SHORT_SHA=$(git rev-parse --short HEAD)" \
273265
"--config=ci/build-examples.yaml"
274266
```
@@ -314,13 +306,11 @@ pack build -v \
314306
"gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-tutorial-cloud-bigtable"
315307
docker push "gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-tutorial-cloud-bigtable"
316308
gcloud run deploy gcf-tutorial-cloud-bigtable \
317-
--project="${GOOGLE_CLOUD_PROJECT}" \
318309
--image="gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-tutorial-cloud-bigtable:latest" \
319310
--region="us-central1" \
320311
--platform="managed" \
321312
--allow-unauthenticated
322313
BIGTABLE_SERVICE_URL=$(gcloud run services describe \
323-
--project="${GOOGLE_CLOUD_PROJECT}" \
324314
--platform="managed" \
325315
--region="us-central1" \
326316
--format="value(status.url)" \
@@ -333,7 +323,7 @@ curl -H "projectID: ${GOOGLE_CLOUD_PROJECT}" -H "instanceID: test-instance-0" -H
333323
Create the instance:
334324

335325
```shell
336-
gcloud --project="${GOOGLE_CLOUD_PROJECT}" spanner instances create test-instance-0 \
326+
gcloud spanner instances create test-instance-0 \
337327
--config="regional-us-central1" \
338328
--description="Test instance for CI builds" \
339329
--nodes=1
@@ -358,14 +348,12 @@ pack build -v \
358348
"gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-tutorial-cloud-spanner"
359349
docker push "gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-tutorial-cloud-spanner"
360350
gcloud run deploy gcf-tutorial-cloud-spanner \
361-
--project="${GOOGLE_CLOUD_PROJECT}" \
362351
--image="gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-tutorial-cloud-spanner:latest" \
363352
--region="us-central1" \
364353
--platform="managed" \
365354
--set-env-vars=GOOGLE_CLOUD_PROJECT="${GOOGLE_CLOUD_PROJECT}",SPANNER_INSTANCE=test-instance-0,SPANNER_DATABASE=test-db \
366355
--allow-unauthenticated
367356
SPANNER_SERVICE_URL=$(gcloud run services describe \
368-
--project="${GOOGLE_CLOUD_PROJECT}" \
369357
--platform="managed" \
370358
--region="us-central1" \
371359
--format="value(status.url)" \

‎examples/README.md‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ docker kill ${ID}
8080
## Deploying to Cloud Run
8181

8282
This example assumes that `GOOGLE_CLOUD_PROJECT` is set to a GCP project with
83-
the right services enabled:
83+
the correct services enabled:
8484

8585
```sh
8686
GOOGLE_CLOUD_PROJECT=... # use a real project
@@ -102,11 +102,16 @@ Push this image to Google Container Registry:
102102
docker push gcr.io/${GOOGLE_CLOUD_PROJECT}/hello-world:latest
103103
```
104104

105+
Set the active project:
106+
107+
```sh
108+
gcloud config set project ${GOOGLE_CLOUD_PROJECT}
109+
```
110+
105111
Deploy this application to Cloud Run:
106112

107113
```sh
108114
gcloud run deploy gcf-cpp-hello \
109-
"--project=${GOOGLE_CLOUD_PROJECT}" \
110115
"--image=gcr.io/${GOOGLE_CLOUD_PROJECT}/hello-world:latest" \
111116
"--region=${GOOGLE_CLOUD_REGION}" \
112117
"--platform=managed" \
@@ -117,7 +122,6 @@ Fetch the service URL:
117122

118123
```bash
119124
SERVICE_URL=$(gcloud run services list \
120-
"--project=${GOOGLE_CLOUD_PROJECT}" \
121125
"--platform=managed" \
122126
'--format=csv[no-heading](URL)' \
123127
"--filter=SERVICE:gcf-cpp-hello")

‎examples/site/howto_deploy_cloud_event/README.md‎

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -117,9 +117,14 @@ To deploy this image in Cloud Run use this command. You need to select
117117
a Cloud Run region for your deployment. We will use `us-central1` in this
118118
guide:
119119

120+
Set the active project:
121+
122+
```sh
123+
gcloud config set project ${GOOGLE_CLOUD_PROJECT}
124+
```
125+
120126
```shell
121127
gcloud run deploy gcf-cpp-hello-world-pubsub \
122-
--project="${GOOGLE_CLOUD_PROJECT}" \
123128
--image="gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-cpp-hello-world-pubsub:latest" \
124129
--region="us-central1" \
125130
--platform="managed" \
@@ -130,7 +135,6 @@ Verify unauthenticated requests are allowed:
130135

131136
```shell
132137
gcloud run services get-iam-policy gcf-cpp-hello-world-pubsub \
133-
--project="${GOOGLE_CLOUD_PROJECT}" \
134138
--region="us-central1" \
135139
--platform="managed"
136140
```
@@ -152,7 +156,6 @@ proceed run this command (maybe with an addition `--topic-transport` option):
152156

153157
```shell
154158
gcloud beta eventarc triggers create gcf-cpp-hello-world-pubsub-trigger \
155-
--project="${GOOGLE_CLOUD_PROJECT}" \
156159
--location="us-central1" \
157160
--destination-run-service="gcf-cpp-hello-world-pubsub" \
158161
--destination-run-region="us-central1" \
@@ -163,7 +166,6 @@ Find out what topic is used to this new trigger:
163166

164167
```shell
165168
TOPIC=$(gcloud beta eventarc triggers describe gcf-cpp-hello-world-pubsub-trigger \
166-
--project="${GOOGLE_CLOUD_PROJECT}" \
167169
--location="us-central1" \
168170
--format="value(transport.pubsub.topic)")
169171
```
@@ -181,7 +183,6 @@ to verify the Pub/Sub message was received:
181183

182184
```shell
183185
gcloud logging read \
184-
--project="${GOOGLE_CLOUD_PROJECT}" \
185186
--format="value(textPayload)" \
186187
"resource.type=cloud_run_revision AND resource.labels.service_name=gcf-cpp-hello-world-pubsub AND logName:stdout"
187188
# Output: Hello Event
@@ -193,15 +194,13 @@ Delete the trigger:
193194

194195
```shell
195196
gcloud beta eventarc triggers delete gcf-cpp-hello-world-pubsub-trigger \
196-
--project="${GOOGLE_CLOUD_PROJECT}" \
197197
--location="us-central1"
198198
```
199199

200200
Delete the Cloud Run deployment:
201201

202202
```sh
203203
gcloud run services delete gcf-cpp-hello-world-pubsub \
204-
--project="${GOOGLE_CLOUD_PROJECT}" \
205204
--region="us-central1" \
206205
--platform="managed"
207206
```

‎examples/site/howto_deploy_to_cloud_run/README.md‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -119,9 +119,15 @@ To deploy this image in Cloud Run use this command. You need to select
119119
a Cloud Run region for your deployment. We will use `us-central1` in this
120120
guide:
121121

122+
Set the active project:
123+
124+
```sh
125+
gcloud config set project ${GOOGLE_CLOUD_PROJECT}
126+
```
127+
128+
122129
```sh
123130
gcloud run deploy gcf-cpp-hello-world-http \
124-
--project="${GOOGLE_CLOUD_PROJECT}" \
125131
--image="gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-cpp-hello-world-http:latest" \
126132
--region="us-central1" \
127133
--platform="managed" \
@@ -134,7 +140,6 @@ Find out what URL was assigned to your function, and use `curl` to send a reques
134140

135141
```shell
136142
HTTP_SERVICE_URL=$(gcloud run services describe \
137-
--project="${GOOGLE_CLOUD_PROJECT}" \
138143
--platform="managed" \
139144
--region="us-central1" \
140145
--format="value(status.url)" \
@@ -150,7 +155,6 @@ Delete the Cloud Run deployment:
150155

151156
```sh
152157
gcloud run services delete gcf-cpp-hello-world-http \
153-
--project="${GOOGLE_CLOUD_PROJECT}" \
154158
--region="us-central1" \
155159
--platform="managed"
156160
```

‎examples/site/testing_pubsub/README.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -80,12 +80,17 @@ pack build \
8080
"gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-hello-world-pubsub"
8181
```
8282

83+
Set the active project:
84+
85+
```sh
86+
gcloud config set project ${GOOGLE_CLOUD_PROJECT}
87+
```
88+
8389
Deploy this function to Cloud Run:
8490

8591
```shell
8692
docker push "gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-hello-world-pubsub"
8793
gcloud run deploy gcf-hello-world-storage \
88-
--project="${GOOGLE_CLOUD_PROJECT}" \
8994
--image="gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-hello-world-pubsub:latest" \
9095
--region="us-central1" \
9196
--platform="managed" \
@@ -96,7 +101,6 @@ Setup a Pub/Sub trigger:
96101

97102
```shell
98103
gcloud beta eventarc triggers create gcf-hello-world-pubsub-trigger \
99-
--project="${GOOGLE_CLOUD_PROJECT}" \
100104
--location="us-central1" \
101105
--destination-run-service="gcf-hello-world-pubsub" \
102106
--destination-run-region="us-central1" \

‎examples/site/testing_storage/README.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -73,12 +73,17 @@ pack build \
7373
"gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-hello-world-storage"
7474
```
7575

76+
Set the active project:
77+
78+
```sh
79+
gcloud config set project ${GOOGLE_CLOUD_PROJECT}
80+
```
81+
7682
Then deploy this function to Cloud Run:
7783

7884
```shell
7985
docker push "gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-hello-world-storage"
8086
gcloud run deploy gcf-hello-world-storage \
81-
--project="${GOOGLE_CLOUD_PROJECT}" \
8287
--image="gcr.io/${GOOGLE_CLOUD_PROJECT}/gcf-hello-world-storage:latest" \
8388
--region="us-central1" \
8489
--platform="managed" \
@@ -105,7 +110,6 @@ topic:
105110

106111
```shell
107112
gcloud beta eventarc triggers create gcf-hello-world-storage-trigger \
108-
--project="${GOOGLE_CLOUD_PROJECT}" \
109113
--location="us-central1" \
110114
--destination-run-service="gcf-hello-world-storage" \
111115
--destination-run-region="us-central1" \
@@ -129,7 +133,6 @@ Remember to remove your deployment and the image once you have finished:
129133

130134
```sh
131135
gcloud run services delete gcf-cpp-hello-world-storage \
132-
--project="${GOOGLE_CLOUD_PROJECT}" \
133136
--region="us-central1" \
134137
--platform="managed"
135138
gcloud container images delete \

0 commit comments

Comments
 (0)