Runme Cloud Renderers with Google Cloud Run
Runme Cloud Renderers enable you to access various cloud resources directly within your Markdown files without the need to log into your cloud console. With Cloud Renderers, you can manage your Google Cloud Run resources and perform various operations without leaving your Markdown environment.
It is available on Runme client interfaces, including the editor and web browser. This section will explore how you can access the Google Cloud Run with Runme Cloud Renderers in a web browser.
Prerequisites
Before proceeding, ensure you have the following installed:
- Install Runme
To access Runme on your web browser, you are required to install Runme on your terminal. To do that, run the command below:
brew install runme
Check out our detailed installation guide for instructions on installing Runme CLI on other operation systems.
- Change directory
The next step is to navigate into your directory. However, if you do not have an existing folder you would love to work on, you can create a new folder or clone the repo you want to work with.
To create a folder, run the command below
mkdir my_new_directory
Where my_new_directory is the name of your folder.
Now, navigate into that directory by changing directory to my_new_directory.
- Open the Web Browser
Now, open the browser by running this command.
runme open
This will load and open Runme in your default web browser and set up a Runme code-server.
Now, create a README.md file and run the following sections below inside the code cell one after the other.
- Install Google Cloud SDK
Google Cloud SDK is one requirement that must be installed to interact with your Google Cloud resources. It provides the necessary tools and libraries for users. To install the Google Cloud SDK, run the command below.
brew install --cask google-cloud-sdk
For other platforms, consult GCP’s official docs.
Authenticate with Google Cloud
The next step is to authenticate your account. This step is crucial as it allows you to access your cloud resources. To authenticate, run the command below.
gcloud auth login
Setup Default Credentials
Setting up default application credentials allows applications to access your Google Cloud resources without requiring further authentication prompts. To set up your credentials, run the command below:
gcloud auth application-default login
How to Manage Google Cloud Run with Runme Cloud Renderers
Google Cloud Run is a service that allows you to run your containerized applications directly on Google’s infrastructure without worrying about infrastructure management. With Runme Cloud Renderers, you can access, list, and visualize Cloud Run services directly in your Markdown file.
This section will explain how Google Cloud Run works in Runme Notebook Cloud Renderers.
Set Your Project ID Using an Environment Variable
Use the environment variable prompts to set your project ID. Run the command below to experience how it works.
export PROJECT_ID="runme-ci"
echo "PROJECT_ID set to $PROJECT_ID"
This is how the prompt looks like.
Specify the Project for Visualization
After setting your project ID, you can visualize your project. To do this, paste a link from your console that specifies the desired project for visualization, like the link below, and click run.
https://console.cloud.google.com/run?project=$PROJECT_ID
In this example, runme-ci is the project ID.
Once the operation is successful, you will receive a table displaying your Google Cloud Console page, similar to the one below.
If you would love to view the logs of a particular project under the actions section, click the icon beside Revisons. This will take you to the log page of your console, where you can view the logs.
Access and Manage Project Revisions
Runme Notebook Cloud Renderers makes accessing and managing the details of your Cloud Run project possible. This section will explore how it does it.
Get Revision
To get the revision of a project, click the Revisions icon beside the project name, as indicated in the image below.
This will create a new code cell to run automatically and display a table with your project revisions.
To view more details about your project, click the Details icon beside the project name.
This will load a table that will provide details of your project, such as containers, volumes, storage, network, security, and YAML.
Visualize and Download YAML
Once you have gotten the details of your revision, navigate to the section on YAML.
You will find two gcloud commands, Visualize and Download.
To visualize the project YAML configurations, click Run under the visualize section.
This will add a new code block, which will run automatically to visualize your YAML configuration in Runme’s terminal.
On the other hand, to download the project YAML configurations, click Run under the download section.
This will add a new code block that automatically downloads your YAML configuration. Once that is successful, the terminal will show that the operation has been completed, and the .yaml will be added to your current directory.
Feedback and Contribution
We are still developing more features for the Runme Notebook Cloud Renderers. If you have feedback on this or new ideas on how to improve this feature, feel free to reach out to us.
Additional Resources
See more resources on the Runme Cloud Notebook Renderer feature: