Przejdź do treści
Biblioteka skilli
DevOps i chmura · Integracja z narzędziem

gcloud

/gcloud

Używa gcloud w piaskownicy Centaur, gdzie proxy dopisuje dane logowania do Google Cloud, i rozwiązuje błędy 401, 403 oraz SERVICE_DISABLED.

Repozytorium
centaur ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Używa gcloud w piaskownicy Centaur, gdzie proxy dopisuje dane logowania do Google Cloud, i rozwiązuje błędy 401, 403 oraz SERVICE_DISABLED.

Oryginalny opis (EN)

Use the gcloud CLI from a Centaur sandbox, where iron-proxy injects Google Cloud credentials on the wire. Use before any gcloud command, Google Cloud deploy, Cloud Run, Cloud Build, Artifact Registry, Cloud Storage, or IAM task, and whenever gcloud reports no credentialed account, asks you to run `gcloud auth login`, or a Google API returns 401, 403, or SERVICE_DISABLED.

Jak działa

  1. Setup
  2. Rules
  3. Known limits
  4. Failures
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 663 słów
Podgląd SKILL.md
---
name: gcloud
description: "Use the gcloud CLI from a Centaur sandbox, where iron-proxy injects Google Cloud credentials on the wire. Use before any gcloud command, Google Cloud deploy, Cloud Run, Cloud Build, Artifact Registry, Cloud Storage, or IAM task, and whenever gcloud reports no credentialed account, asks you to run `gcloud auth login`, or a Google API returns 401, 403, or SERVICE_DISABLED."
---

# gcloud in a Centaur sandbox

The sandbox has no local Google login. When the current principal holds a GCP credential grant, iron-proxy adds a real `Authorization` header to each Google API request as it leaves the sandbox. So `gcloud auth list` shows no credentialed account even when access works. **Never report "no GCP credentials" or "no authenticated account" because of `gcloud auth list` or `gcloud config get-value account`.** Make a real call first.

## Setup

gcloud refuses to send requests without a local credential. Give it a placeholder token, which the proxy replaces:

```bash
printf 'placeholder' > /tmp/gcp-placeholder-token
export CLOUDSDK_AUTH_ACCESS_TOKEN_FILE=/tmp/gcp-placeholder-token
gcloud run services list --project=<project> --region=<region>
```

Set the variable in the same shell command as the gcloud call, because shell state does not persist between tool calls. `--access-token-file=/tmp/gcp-placeholder-token` on a single command works too. With the variable set, `gcloud auth print-access-token` prints `placeholder`. Scripts that pass that value in an `Authorization` header still work, because the proxy overwrites the header.

## Rules

- Always pass `--project`. There is no default project.
- If a call fails with `SERVICE_DISABLED` for an API in a project you did not name (often Cloud Resource Manager), gcloud billed the request to the wrong quota project. Retry with `--billing-project=<a project where that API is enabled>`.
- Before acting, find out which identity you have. It depends on the surface:
  - DMs usually use the requester's personal Google OAuth.
  - Shared channels use service accounts granted to the channel.
  - A principal can hold several GCP credentials, scoped to different Google API hosts, so Cloud Run and Cloud Storage may act as different accounts.
- To see the principal for a host, make a harmless read that is likely to be denied. Storage errors name the caller: `gcloud storage ls gs://<bucket-you-cannot-read>` → `<principal> does not have storage.objects.list access`.
- Personal credentials act as a real person. Stay within the project the user named, read before you write, and ask before any destructive or IAM-changing command unless the user already asked for that exact change.
- Never print, log, or store real tokens. You never hold one anyway, so do not try to extract one.

## Known limits

- **ID tokens cannot be minted.** `gcloud auth print-identity-token` fails with `No identity token can be obtained from the current credentials`. Calls to private Cloud Run services work only for hosts where the deployment configured an ID-token credential. Anything else, including smoke tests that call `print-identity-token`, has to be run by a human from an authenticated shell. Give them the exact command.
- **Scripts that read `gcloud config get-value account` get an empty value.** Read the script before running it, and pass the account explicitly or hand that step to a human.
- **`bq` fails TLS verification through the proxy.** Use `gcloud` or a Google client library instead.
- **Client libraries** start from the sandbox's mock `GOOGLE_APPLICATION_CREDENTIALS`. They work when the proxy handles the token exchange for that credential. If you see `invalid_grant: account not found` or signing errors for `mock@creds.com`, switch to gcloud. Signed URLs and `signBlob` never work.

## Failures

| Symptom | Meaning | Action |
|---|---|---|
| `You do not currently have an active account selected` | No placeholder token was set. | Set `CLOUDSDK_AUTH_ACCESS_TOKEN_FILE` and retry. |
| `401 ACCESS_TOKEN_TYPE_UNSUPPORTED`, `Invalid Credentials` | The proxy did not inject a usable token for that host, usually because the principal has no GCP grant covering it. | Report the missing grant. Follow the `auth-failure-log-triage` skill for proxy evidence. |
| `403 PERMISSION_DENIED` naming a permission | The injected identity lacks IAM for that action. | Report the principal, the permission, and the resource. Offer the `gcloud ... add-iam-policy-binding` command for an owner to run. Do not retry with another identity. |
| `SERVICE_DISABLED` for the target project | The API is off in that project. | Ask an owner to run `gcloud services enable <api> --project=<project>`, unless you were asked to enable it and have `serviceusage.services.enable`. |

Wersje

RepozytoriumWynikLicencja
Ta strona · paradigmxyz/centaur100MIT
google/skills100Apache-2.0
google/skills100Apache-2.0
TerminalSkills/skills100Apache-2.0
dreamlab-ai/agentbox100AGPL-3.0
rittmananalytics/wire-plugin100Apache-2.0
yangshun2005/skills-cn100Apache-2.0
hamzabellouch/agent-skills100MIT
AkshatNaruka/aidentity100MIT

Migawka bazy z 13.11.2026 · wersja paczki cbea8a4791bf (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100gcloud-cli-health-check
    Sprawdza kondycję Google Cloud CLI: instalację, uwierzytelnienie, aktywny projekt, region, włączone API, token dostępu, rozliczenia, wiązania IAM, konta usługowe i usługi Cloud Run w projektach głównym i dodatkowym.
  • 85gcloud-auth-verification
    Pomaga rozwiązać problemy z uwierzytelnieniem Google Cloud i Application Default Credentials przy błędach gcloud, bq lub bibliotek Python.
  • 100gcp
    Zarządza architekturą Google Cloud, IAM, gcloud, Cloud Run i klastrami GKE, a także wyjaśnia rachunki za usługi.
  • 100gcloud-setup
    Instaluje i uwierzytelnia Google Cloud CLI (gcloud, gsutil, bq) na macOS, dodaje zakresy OAuth dla API Google i naprawia problemy z Application Default Credentials.
  • 100gcloud-usage
    Pomaga w pracy z logami GCloud, zapytaniami Cloud Logging, metrykami Google Cloud, obserwowalnością GCP, analizą śladów i debugowaniem problemów produkcyjnych.
  • 100cloud-run
    Wdraża i zarządza kontenerowymi obciążeniami na Cloud Run: tworzenie usług, podział ruchu, IAM, łączność VPC, sekrety, autoskalowanie i polecenia gcloud, z ostrzeżeniem przed płatnymi wdrożeniami.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.