Deploy your Astro Site to Google Cloud
Google Cloud is a full-featured web app hosting platform that can be used to deploy an Astro site.
How to deploy
Section titled How to deployCloud Storage (static only)
Section titled Cloud Storage (static only)-
Create a new GCP project, or select one you already have.
-
Create a new bucket under Cloud Storage.
-
Give it a name and the other required settings.
-
Upload your
distfolder into it or upload using Cloud Build. -
Enable public access by adding a new permission to
allUserscalledStorage Object Viewer. -
Edit the website configuration and add
ìndex.htmlas the entrypoint and404.htmlas the error page.
Cloud Run (SSR and static)
Section titled Cloud Run (SSR and static)Cloud Run is a serverless platform that allows you to run a container without having to manage any infrastructure. It can be used to deploy both static and SSR sites.
Prepare the Service
Section titled Prepare the Service-
Create a new GCP project, or select one you already have.
-
Make sure the Cloud Run API is enabled.
-
Create a new service.
Create Dockerfile & Build the Container
Section titled Create Dockerfile & Build the ContainerBefore you can deploy your Astro site to Cloud Run, you need to create a Dockerfile that will be used to build the container. Find more information about how to use Docker with Astro in our recipe section.
Once the Dockerfile is created, build it into an image and push it to Google Cloud. There are a few ways to accomplish this:
Build locally using Docker:
Use the docker build command to build the image, docker tag to give it a tag, then docker push to push it to a registry. In the case of Google Cloud, Artifact Registry is the easiest option, but you can also use Docker Hub.
# build your containerdocker build .
docker tag SOURCE_IMAGE HOSTNAME/PROJECT-ID/TARGET-IMAGE:TAG
# Push your image to a registrydocker push HOSTNAME/PROJECT-ID/IMAGE:TAGChange the following values in the commands above to match your project:
SOURCE_IMAGE: the local image name or image ID.HOSTNAME: the registry host (gcr.io,eu.gcr.io,asia.gcr.io,us.gcr.io).PROJECT: your Google Cloud project ID.TARGET-IMAGE: the name for the image when it’s stored in the registry.TAGis the version associated with the image.
Read more in the Google Cloud docs.
Using another tool:
You can use a CI/CD tool that supports Docker, like GitHub Actions.
Build using Cloud Build:
Instead of building the Dockerfile locally, you can instruct Google Cloud to build the image remotely. See the Google Cloud Build documentation here.
Deploying the container
Section titled Deploying the containerDeployment can be handled manually in your terminal using gcloud or automatically using Cloud Build or any other CI/CD system.
