cloudrun-development

Deploy CloudBase Run backend services in Function or Container mode.

Updated May 14, 2026
One-click install
npx skills add https://github.com/williamwang25/ams-admin --skill cloudrun-development-williamwang25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cloudrun-development
Source: https://github.com/williamwang25/ams-admin/tree/main/.windsurf/skills/cloudbase/references/cloudrun-development
Command: npx skills add https://github.com/williamwang25/ams-admin --skill cloudrun-development-williamwang25

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you design and deploy CloudBase Run backend services by preventing common deployment and runtime mistakes that cause downtime, broken connectivity, or incorrect access behavior.

Core Features & Use Cases

  • CloudRun service lifecycle management: Initialize, download code, local-run (Function mode where supported), deploy, inspect, and delete services with correct tool routing.
  • Function vs Container mode guidance: Choose the right mode for long-lived HTTP/SSE/WebSocket needs or for custom Docker/runtime requirements.
  • Operational guardrails: Enforce required runtime rules like listening on the injected PORT, keeping services stateless, and externalizing durable data.
  • Agent service enablement: Create and deploy agent services on CloudBase Run with pointers to the dedicated Agent SDK skill.

Quick Start

Ask an AI agent to deploy a CloudBase Run backend in Function mode by selecting the right access type, ensuring the service listens on the provided PORT, and then running the deploy flow for a stateless service at a given absolute target path.

Frequently Asked Questions about cloudrun-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a backend service for SSE or WebSocket on CloudBase Run?

Deploying a stateless backend for SSE or WebSocket on CloudBase Run requires selecting Function or Container mode, listening on the injected PORT, and using manageCloudRun actions to execute the deployment flow at an absolute target path.

What is the difference between Function mode and Container mode for CloudBase Run deployment?

Function mode handles standard HTTP needs, whereas Container mode supports custom Dockerfile and runtime requirements. Selecting the correct mode ensures long-lived SSE or WebSocket connectivity and prevents broken access behavior during CloudBase Run deployment.

Why does my CloudBase Run service lose connectivity or fail during deployment?

CloudBase Run services fail or lose connectivity when they do not listen on the injected PORT, use stateful designs, or use relative paths. Enforcing stateless backend design, externalizing durable data, and using absolute target paths prevents these deployment and runtime mistakes.

Can I use a custom Dockerfile for my stateless backend on CloudBase Run?

Yes, you can use a custom Dockerfile by selecting Container mode for your CloudBase Run deployment. Container mode accommodates custom runtime requirements while enforcing operational guardrails like listening on the injected PORT and maintaining stateless backend design.

How do I inspect and debug an existing CloudBase Run service?

To inspect and debug a CloudBase Run service, use the queryCloudRun action for read operations and manageCloudRun for write operations. Correct tool routing ensures safe inspection of your stateless backend without causing downtime or broken connectivity.

Do I need a specific Agent SDK to create an agent service on CloudBase Run?

Creating an agent service on CloudBase Run involves deploying a stateless backend and using pointers to a dedicated Agent SDK. You must ensure correct port configuration and mode selection before deploying the agent service.