https://github.com/mchmarny/gorunstarter
Simple GitHub repo template for Cloud Run project in go
https://github.com/mchmarny/gorunstarter
cloudrun dockerfile gcp quickstart service
Last synced: 12 months ago
JSON representation
Simple GitHub repo template for Cloud Run project in go
- Host: GitHub
- URL: https://github.com/mchmarny/gorunstarter
- Owner: mchmarny
- License: apache-2.0
- Created: 2019-07-31T06:27:25.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-01-24T23:36:03.000Z (about 6 years ago)
- Last Synced: 2024-12-31T22:43:00.970Z (about 1 year ago)
- Topics: cloudrun, dockerfile, gcp, quickstart, service
- Language: Shell
- Homepage: https://cloud.google.com/run/
- Size: 24.4 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gorunstarter
Simple [Cloud Run](https://cloud.google.com/run/) starter project for `go` meant to be used as a GitHub repository template to speed up new Cloud Run service development by removing the need to re-create the common "boilerplate" code and simplifying common steps.
## Audience
For developers wanting to quickly start their `go` service development on [Cloud Run](https://cloud.google.com/run/) from a well-structured template with minimal amount of external dependencies.
> This is not an official or standard Cloud Run project layout, just a set of common initial bits that are helpful to me.
## Usage
To use this template when creating a new Cloud Run service, just click on the "use this template" button and follow the prompts.
Your newly created project based on the `gorunstarter` template will also include the three basic steps of Cloud Run developer workflow. You can click on the below links to see the content of these commands.
> For complete walk-through build and deploy see the [Cloud Run Quickstart](https://cloud.google.com/run/docs/quickstarts/build-and-deploy)
[Building a container image](bin/build-container-image) which submits job to Cloud Build using the included [Dockerfile](./Dockerfile) and results in versioned, non-root container image URI which will be used to deploy your service to Cloud Run.
```shell
bin/build-container-image
```
[Creating a service account](bin/create-service-account) which configures least privilege IAM service account which identity the deployed Cloud Run service will run under.
```shell
bin/create-service-account
```
[Deploying Cloud Run service](bin/deploy-cloud-run-service) which deploys public (i.e. unauthenticated) Cloud Run service configured with environment variable and service account identity using the previously built container image.
```shell
bin/deploy-cloud-run-service
```
## Cleanup
To cleanup all resources created by this sample execute
```shell
bin/cleanup
```
## Disclaimer
This is my personal project and it does not represent my employer. I take no responsibility for issues caused by this code. I do my best to ensure that everything works, but if something goes wrong, my apologies is all you will get.