Skip to content

docs: updates to cloud shell guide #2543

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.

Sign up for GitHub

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

Merged
merged 3 commits into from
Jun 27, 2025
Merged

docs: updates to cloud shell guide #2543

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
dd6830b
updates to cloud shell guide
pcoet Jun 27, 2025
5f2cb2e
fix formatting issue in markdown ref link
pcoet Jun 27, 2025
ad92bdf
fix trailing space
pcoet Jun 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 18 additions & 6 deletions guide/src/setting_up_rust_on_cloud_shell.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,17 @@ limitations under the License.

# Setting up Rust on Cloud Shell

Cloud Shell is a great environment to run small examples and tests.
Cloud Shell is a great environment to run small examples and tests. This guide
shows you how to configure Rust and install one of the Cloud Client Libraries in
Cloud Shell.

## Start up Cloud Shell

1. Open <https://shell.cloud.google.com> to start a new shell.
1. In the Google Cloud console [project selector], select a project.

1. Select a project.
1. Open <https://shell.cloud.google.com> to start a new shell. You might be
prompted to [authorize Cloud Shell] to use your credentials for Google Cloud
API calls.

## Configure Rust

Expand Down Expand Up @@ -53,19 +57,19 @@ Cloud Shell is a great environment to run small examples and tests.
cd my-project
```

1. Add the [Secret Manager] client library to the new project
1. Add the [Secret Manager] client library to the new project:

```shell
cargo add google-cloud-secretmanager-v1
```

1. Add the [google-cloud-gax] crate to the new project
1. Add the [google-cloud-gax] crate to the new project:

```shell
cargo add google-cloud-gax
```

1. Add the [tokio] crate to the new project
1. Add the [tokio] crate to the new project:

```shell
cargo add tokio --features macros
Expand All @@ -85,10 +89,18 @@ Cloud Shell is a great environment to run small examples and tests.
cargo run [PROJECT ID]
```

The program will print the secrets associated with your project ID. If you
don't see any secrets, you might not have any in Secret Manager. You can
[create a secret] and rerun the program, and you should see the secret
printed in the output.

<!-- markdownlint-enable MD029 -->

[authorize cloud shell]: https://cloud.google.com/shell/docs/auth
[cloud shell]: https://cloud.google.com/shell
[create a secret]: https://cloud.google.com/secret-manager/docs/creating-and-accessing-secrets
[google-cloud-gax]: https://crates.io/crates/google-cloud-gax
[project selector]: https://console.cloud.google.com/projectselector2/home/dashboard
[rustup]: https://rust-lang.github.io/rustup/
[secret manager]: https://cloud.google.com/secret-manager/docs/overview
[tokio]: https://crates.io/crates/tokio
Loading