Skip to content
Get packs

Filestore Mount Troubleshooting

Diagnoses Filestore NFS mount failures, EACCES permission errors and firewall timeouts on Google Cloud.

Source Download skill
Repository
google/skills
Stars
21,782
Licence
Apache-2.0
Files
7 files

What it does

When a Filestore network file share on Google Cloud will not mount or suddenly stops working, this skill guides the agent through checking the likely causes: VPC firewall rules, the share's export access list, and the client's IP or GKE node subnet. The agent can then explain findings and suggest fixes. It also includes a bundled Python script that can run these checks against a live instance, and it is designed to ask for your confirmation before changing anything.

Great for

  • Engineers whose VM, GKE pod, Cloud Run service or Vertex AI job cannot mount a Filestore share
  • Cloud admins investigating a share that broke after a firewall or export-policy change

Skip it if

  • Cloud Storage buckets, Persistent Disk or NetApp Volumes, which the skill explicitly excludes
  • Capacity scaling or backup/export-policy auditing, also excluded, so the skill may not be the right tool (risk: wrong advice for those tasks)

Try asking

  • “My GKE pod cannot mount the Filestore share at 10.0.0.2 and gets Connection timed out. Find out why.”
  • “Check whether firewall rules allow client subnet 10.4.0.0/14 to reach instance ml-data in us-central1.”
  • “Explain what causes EACCES when mounting Filestore, without running any commands.”
Step-by-step guide: how to use Filestore Mount TroubleshootingInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 7 original files, the Apache-2.0 licence and an attribution note.

    google-cloud-filestore-log-troubleshooting.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip google-cloud-filestore-log-troubleshooting.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip google-cloud-filestore-log-troubleshooting.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the instance ID, location, project and client IP or subnet up front so the agent does not need to ask.
  • Use the no-command mode or --json output if you want a read-only review before any action.
  • Treat mock fleet data in the references as examples only; always verify against live resources.

What's inside

  • references/error-signatures.md
  • references/logging-and-audit-queries.md
  • references/mock-fleet-data.md
  • references/network-firewall-spec.md
  • scripts/diagnose_lib.py
  • scripts/quick_diagnose.py
  • SKILL.md

Redistributed unmodified from google/skills under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.