cloudrun-development

CloudBase Run backend development rules (Function mode/Container mode). Use this skill when deploying backend services that require long connections, multi-language support, custom environments, or AI agent development.

1. Oceń, czy CloudBase Run to właściwy wybór: użyj tej umiejętności dla usług wymagających długich połączeń (WebSocket, SSE, server push), procesów w tle, niestandardowych zależności systemowych lub wsparcia dla języków takich jak Java, Go, PHP, .NET, Python czy Node.js. Nie używaj jej do prostych funkcji chmurowych, aplikacji tylko frontendowych ani projektowania schematów baz danych.

2. Wybierz tryb pracy: tryb funkcji (Function mode) jest szybszy do wdrożenia, ma wbudowaną obsługę HTTP/WebSocket/SSE i nasłuchuje na porcie 3000; tryb kontenera (Container mode) obsługuje dowolny język i runtime, ale wymaga Dockerfile'a i nie wspiera lokalnego uruchamiania przez narzędzia.

3. Spełnij obowiązkowe wymagania dla usługi: aplikacja musi nasłuchiwać na zmiennej środowiskowej PORT (rzeczywisty port w kontenerze), powinna być bezstanowa (dane zapisuj zewnętrznie w bazie, magazynie lub cache), nie uruchamiaj trwałych wątków ani procesów w tle poza żądaniami HTTP.

4. Zoptymalizuj rozmiar i wydajność: minimalizuj zależności i rozmiar obrazu, aby skrócić czas cold start i wdrażania. Pamiętaj o ograniczeniach zasobów: pamięć powinna być równa 2 × CPU (np. 0,25 vCPU → 0,5 GB).

5. Skonfiguruj dostęp sieciowy: włącz publiczną sieć tylko dla scenariuszy webowych; dla mini-programów priorytetyzuj wewnętrzne połączenia bezpośrednie (callContainer).

6. Wdrażaj i skaluj: usługa będzie elastycznie skalowana z modelem pay-as-you-go i może skalować się do zera, gdy nie jest używana.