Deploy a Cloud Run service by using Cloud Code for Cloud Shell
Stay organized with collections
Save and categorize content based on your preferences.
Learn how to set up and deploy a sample Hello World application to
Cloud Run and view the status of your live service's resources.
Before you begin
Sign in to your Google Cloud account. If you're new to
Google Cloud,
create an account to evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
From the Cloud Code status bar, select New Application.
Choose Cloud Run application as your preferred application type.
From the list of sample applications, choose a Hello World app. For example, choosing
Python (Flask): Hello World creates a starter
Python (Flask) Hello World app.
Select a folder as your application location and then click
Create New Application. Cloud Shell Editor loads the application in a new
workspace. After the workspace loads, your app is accessible in the explorer view.
Deploy to Cloud Run
To deploy your application to Cloud Run:
Choose the Deploy to Cloud Run command using
the command palette (accessible with Ctrl/Cmd+Shift+P).
This brings up the Cloud Run Deploy UI.
If prompted, authorize Cloud Code to make Google Cloud API calls.
Set your Google Cloud project.
If prompted, enable the Cloud Run API by clicking Enable APIs.
In the Deploy to Cloud Run dialog, select a pre-existing service or create
a new one.
If you're creating a new service, choose Cloud Run (fully managed)
under Deployment Platform.
Choose a region to deploy to.
For Authentication, select Allow unauthenticated invocations to make this a public service.
After you define your preferred settings, click Deploy.
Cloud Code builds your image, pushes it to the registry, and
deploys your app to Cloud Run. Your service is now live.
View your running service by following the URL displayed in
your Cloud Run: Deploy dialog.
Edit your service
To edit your application:
With the Explorer view, find the app.py file that implements the service
behavior.
Change the message "It's running!" to a message of your choosing.
After you make this change, choose the Deploy to Cloud Run command
using the command palette.
Check that the service you created is selected in Service Settings.
Click Deploy.
After your application finishes building and deploying, you can refresh your
service to see your updated message.
View logs
You can also view logs from your deployed application with the Log Viewer
that comes with Cloud Code.
To view logs:
To open the Cloud Run Explorer, click
Cloud Code and then expand the Cloud Run section.
Right-click your Cloud Run service and then click View logs.
Refresh your app in the browser, and see the new logs generated by
clicking the Logs refresh button.
Clean up
To avoid incurring charges to your Google Cloud account for
the resources used on this page, follow these steps:
In the Google Cloud console, go to the Manage resources page.
In the project list, select the project that you
want to delete, and then click Delete.
In the dialog, type the project ID, and then click
Shut down to delete the project.
If you're using a pre-existing project and want to delete the resources you created for this
quickstart:
Container image: While Cloud Run doesn't charge when a
service isn't in use, you might still be
charged for storing the container image in Artifact Registry.
To delete your image, open the Artifact Registry page, select the repository that contains your
image, select your image, click Delete, and then click Delete.
Cloud Run service: To delete a Cloud Run
service, from the Cloud Run page in the
Google Cloud console, select the service you'd like to delete, click
Delete, and then click Delete.
Open the Cloud Run page
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 UTC."],[[["\u003cp\u003eYou can deploy a sample Hello World application to Cloud Run using the Cloud Shell Editor, selecting from a list of starter applications like Python (Flask).\u003c/p\u003e\n"],["\u003cp\u003eDeploying involves authorizing Cloud Code, setting your Google Cloud project, enabling the Cloud Run API, and choosing deployment settings like region and authentication.\u003c/p\u003e\n"],["\u003cp\u003eAfter deploying, you can easily edit your live service by modifying the source code, then redeploying with the updated changes directly from the command palette.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code's Log Viewer allows you to monitor the logs of your deployed application, aiding in real-time observation and debugging.\u003c/p\u003e\n"],["\u003cp\u003eTo avoid charges, you have the option to delete the entire project or individual resources like container images and the Cloud Run service directly through the Google Cloud console.\u003c/p\u003e\n"]]],[],null,["# Deploy a Cloud Run service by using Cloud Code for Cloud Shell\n\nLearn how to set up and deploy a sample Hello World application to\nCloud Run and view the status of your live service's resources.\n\nBefore you begin\n----------------\n\n- Sign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\nCreate an application\n---------------------\n\n1. [Launch the Cloud Shell Editor](https://ide.cloud.google.com).\n2. From the Cloud Code status bar, select **New Application**.\n3. Choose **Cloud Run application** as your preferred application type.\n4. From the list of sample applications, choose a Hello World app. For example, choosing `Python (Flask): Hello World` creates a starter Python (Flask) Hello World app.\n5. Select a folder as your application location and then click **Create New Application**. Cloud Shell Editor loads the application in a new workspace. After the workspace loads, your app is accessible in the explorer view.\n\nDeploy to Cloud Run\n-------------------\n\nTo deploy your application to Cloud Run:\n\n1. Choose the **Deploy to Cloud Run** command using the command palette (accessible with `Ctrl`/`Cmd`+`Shift`+`P`). This brings up the Cloud Run Deploy UI.\n2. If prompted, authorize Cloud Code to make Google Cloud API calls.\n3. Set your Google Cloud project.\n4. If prompted, enable the Cloud Run API by clicking **Enable APIs**.\n5. In the Deploy to Cloud Run dialog, select a pre-existing service or create a new one.\n6. If you're creating a new service, choose **Cloud Run (fully managed)** under Deployment Platform.\n7. Choose a region to deploy to.\n8. For Authentication, select **Allow unauthenticated invocations** to make this a public service.\n9. After you define your preferred settings, click **Deploy**. Cloud Code builds your image, pushes it to the registry, and deploys your app to Cloud Run. Your service is now live.\n10. View your running service by following the URL displayed in your Cloud Run: Deploy dialog.\n\nEdit your service\n-----------------\n\nTo edit your application:\n\n1. With the Explorer view, find the `app.py` file that implements the service behavior.\n2. Change the message \"It's running!\" to a message of your choosing.\n3. After you make this change, choose the **Deploy to Cloud Run** command using the command palette.\n4. Check that the service you created is selected in Service Settings.\n5. Click **Deploy**.\n6. After your application finishes building and deploying, you can refresh your service to see your updated message.\n\nView logs\n---------\n\nYou can also view logs from your deployed application with the Log Viewer\nthat comes with Cloud Code.\n\nTo view logs:\n\n1. To open the Cloud Run Explorer, click **Cloud Code** and then expand the **Cloud Run** section.\n2. Right-click your Cloud Run service and then click **View logs**.\n3. Refresh your app in the browser, and see the new logs generated by clicking the Logs refresh button.\n\nClean up\n--------\n\n\nTo avoid incurring charges to your Google Cloud account for\nthe resources used on this page, follow these steps:\n\n| **Caution** : Deleting a project has the following effects:\n|\n| - **Everything in the project is deleted.** If you used an existing project for the tasks in this document, when you delete it, you also delete any other work you've done in the project.\n| - **Custom project IDs are lost.** When you created this project, you might have created a custom project ID that you want to use in the future. To preserve the URLs that use the project ID, such as an `appspot.com` URL, delete selected resources inside the project instead of deleting the whole project.\n|\n|\n| If you plan to explore multiple architectures, tutorials, or quickstarts, reusing projects\n| can help you avoid exceeding project quota limits.\n1. In the Google Cloud console, go to the **Manage resources** page.\n\n [Go to Manage resources](https://console.cloud.google.com/iam-admin/projects)\n2. In the project list, select the project that you want to delete, and then click **Delete**.\n3. In the dialog, type the project ID, and then click **Shut down** to delete the project.\n\nIf you're using a pre-existing project and want to delete the resources you created for this\nquickstart:\n\n- **Container image:** While Cloud Run doesn't charge when a service isn't in use, you might still be [charged for storing the container image in Artifact Registry](/artifact-registry/pricing). To delete your image, open the Artifact Registry page, select the repository that contains your image, select your image, click **Delete** , and then click **Delete** . \n\n [Open the Artifact Registry page](https://console.cloud.google.com/artifacts)\n- **Cloud Run service:** To delete a Cloud Run service, from the Cloud Run page in the Google Cloud console, select the service you'd like to delete, click **Delete** , and then click **Delete** .\n\n \u003cbr /\u003e\n\n [Open the Cloud Run page](https://console.cloud.google.com/run)\n\nWhat's next\n-----------\n\n- Discover the features that the [Cloud Shell Editor interface](/shell/docs/editor-overview) offers.\n- Learn how to [configure Cloud Shell](/shell/docs/configuring-cloud-shell) to customize your experience."]]