Skip to content

aktonay/skillz / skills/cloud/cloud-run-basics

cloud-run-basics

Verified

Manages Cloud Run services, jobs, and worker pools. Use when you need to deploy applications responding to HTTP requests (services), run event-triggered or scheduled tasks (jobs), or handle always-on pull-based background processing (worker pools).

FileKindSize
SKILL.mdskill md15.2 KB
references/cli-usage.mdmarkdown2.4 KB
references/client-library-usage.mdmarkdown3.4 KB
references/core-concepts.mdmarkdown6.5 KB
references/iac-usage.mdmarkdown2.0 KB
references/iam-security.mdmarkdown3.9 KB
references/mcp-usage.mdmarkdown1.9 KB

references/client-library-usage.md

View on GitHub
# Cloud Run Client Libraries

Google Cloud client libraries provide an idiomatic way to manage Cloud Run
resources programmatically.

## Getting Started

Ensure you have the Google Cloud SDK installed and authenticated.
[Install Google Cloud SDK](https://cloud.google.com/sdk/docs/install)

### Python

- **Installation:**

  ```bash
  pip install --upgrade google-cloud-run
  ```

- **Usage Example:**

  ```python
  from google.cloud import run_v2
  client = run_v2.ServicesClient()
  request = run_v2.ListServicesRequest(
    parent="projects/my-project/locations/us-central1"
  )
  page_result = client.list_services(request=request)
  ```

- [Python Reference](https://docs.cloud.google.com/python/docs/reference/run/latest)

### Java

- **Maven Dependency:**

  ```xml
  <dependencyManagement>
  <dependencies>
   <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.79.0</version>
      <type>pom</type>
      <scope>import</scope>
   </dependency>
  </dependencies>
  </dependencyManagement>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-run</artifactId>
  </dependency>
  ```

- **Usage Example:**

  ```java
  try (ServicesClient servicesClient = ServicesClient.create()) {
    ListServicesRequest request = ListServicesRequest.newBuilder()
        .setParent(LocationName.of("my-project", "us-central1").toString())
        .build();
    for (Service element : servicesClient.listServices(request).iterateAll()) {
      System.out.println(element.getName());
    }
  }
  ```

- [Java Reference](https://docs.cloud.google.com/java/docs/reference/google-cloud-run/latest/overview)

### Node.js (TypeScript)

- **Installation:**

  ```bash
  npm install @google-cloud/run
  ```

- **Usage Example:**

  ```typescript
  import {ServicesClient} from '@google-cloud/run';
  const client = new ServicesClient();
  const [services] = await client.listServices({
    parent: 'projects/my-project/locations/us-central1',
  });
  ```

- [Node.js Reference](https://googleapis.dev/nodejs/run/latest/index.html)

### Go

- **Installation:**

  ```bash
  go get cloud.google.com/go/run/apiv2
  ```

- **Usage Example:**

  ```go
  package main

  import (
  	"context"
  	"fmt"
  	"log" // Import the log package

  	run "cloud.google.com/go/run/apiv2"
  	runpb "cloud.google.com/go/run/apiv2/runpb"
  	"google.golang.org/api/iterator"
  )

  func main() {
  	ctx := context.Background()
  	client, err := run.NewServicesClient(ctx)
  	if err != nil {
  		// Log the error and exit if the client can't be created
  		log.Fatalf("Failed to create Cloud Run Services client: %v", err)
  	}
  	defer client.Close()

  	req := &runpb.ListServicesRequest{
  		Parent: "projects/my-project/locations/us-central1", // Remember to replace my-project
  	}
  	it := client.ListServices(ctx, req)

  	fmt.Println("Cloud Run Services:")
  	for {
  		resp, err := it.Next()
  		if err == iterator.Done {
  			break // Finished iterating successfully
  		}
  		if err != nil {
  			// Log the error and exit if iteration fails
  			log.Fatalf("Error iterating services: %v", err)
  		}
  		fmt.Println(resp.GetName())
  	}
  }
  ```

- [Go Reference](https://docs.cloud.google.com/go/docs/reference/cloud.google.com/go/run/latest)

## Source Code Samples

For more examples across languages, visit the
[Cloud Run Code Samples](https://cloud.google.com/run/docs/samples).
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall