Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Add Docker Tutorial Doc #58

Merged
merged 6 commits into from
Aug 6, 2019
Merged

Docs: Add Docker Tutorial Doc #58

merged 6 commits into from
Aug 6, 2019

Conversation

grant
Copy link
Contributor

@grant grant commented Jul 19, 2019

Modifies PR to add instructions on how to deploy the FF to Cloud Run:
See #28
R: @grayside

docs/docker.md Outdated Show resolved Hide resolved
docs/docker.md Outdated

## Deploy a Container

You can deploy your containerized function to Cloud Run or any Knative-based environment by following the [Cloud Run quickstart](https://cloud.google.com/run/docs/quickstarts/build-and-deploy).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cloud Run or Cloud Run on GKE. Other knative instances are managed with kubectl or in the future kn. Instructions for knative in that case will also need a service.yaml.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What would you like me to say instead of Cloud Run?
Does Cloud Run not include Cloud Run on GKE?

Can you suggest a change?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is for Cloud Run only: https://cloud.google.com/run/docs/quickstarts/build-and-deploy

This shows how to build and deploy an existing container image to Cloud Run on GKE: https://cloud.google.com/run/docs/quickstarts/prebuilt-deploy-gke

Deploying to Knative anywhere
https://knative.dev/docs/install/getting-started-knative-app/

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've removed the mention of Cloud Run on GKE.


```sh
docker build -t gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld .
docker push gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note docker push requires some extra steps to get docker authenticating with GCP. In fact, if you use Cloud Build you don't need to get docker working locally at all.

Here are some Cloud Run-specific docs on build options

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How do we want to change these steps? Do we want to link the build options?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Based on your needs, pick Cloud Build or Docker and include mostly bare steps here, linking to that page for more context/options?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

E.g., to keep the current instructions, add gcloud auth configure-docker.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've added the configure docker command.

grant and others added 2 commits July 19, 2019 14:05
Co-Authored-By: Adam Ross <adamross@google.com>
Copy link
Contributor Author

@grant grant left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@grayside Thanks for the review. Can you please take a look?

So long as there is no inaccurate information, I think this PR would be a good addition. If there are extra details that you know of that we could add right now, then please suggest them.

docs/docker.md Outdated

## Deploy a Container

You can deploy your containerized function to Cloud Run or any Knative-based environment by following the [Cloud Run quickstart](https://cloud.google.com/run/docs/quickstarts/build-and-deploy).
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What would you like me to say instead of Cloud Run?
Does Cloud Run not include Cloud Run on GKE?

Can you suggest a change?


```sh
docker build -t gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld .
docker push gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How do we want to change these steps? Do we want to link the build options?

@grant
Copy link
Contributor Author

grant commented Aug 6, 2019

I've updated the doc based on your review comments. Please look!

@grant grant merged commit 8f1f418 into master Aug 6, 2019
@grant grant deleted the grant_docs branch August 6, 2019 22:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants