troubleshooting.md

Troubleshooting

• Troubleshooting
  • Pod won't start
  • 404 errors, or objects not found
  • Page loads blank
    • How to check
      • How to fix this
        • GitHub Actions
  • Open an issue

If you have issues, see if they are on here before opening an issue

A good port of call for any whack issues, is to check the GCS Fuse documentation.

Useful pages are below

• Playbook for Production issues
• Mounting
• Semantics
• GCS Fuse Issues

Pod won't start

If you are using a VPC Native cluster, and don't have nat set up, you won't be able to pull the image.

Consider copying the image to Google Artifact Registry using GCrane

I plan to set up a Google Artifact Registry for images at some point.

404 errors, or objects not found

Use gcsfuse in a session on the pod and mount it to temp with debug, and try open a file.

gcsfuse --foreground --debug_fuse --debug_fs --debug_gcs --debug_http  --implicit-dirs -o allow_other gcs-website /tmp/dir

Then navigate to /tmp/dir in another session and try open a file.

Page loads blank

Ensure that objects copied to the bucket aren't being gzipped on the way.

How to check

Navigate to the GCS bucket where the pages are stored.

Click on the 3 dots on the far right hand side.

Click Edit Metadata

If you see Content-Encoding set to anything but blank (See example below) - Then it won't load.

How to fix this

GitHub Actions

      - name: Upload Files
        id: 'upload-folder'
        uses: 'google-github-actions/upload-cloud-storage@v1'
        with:
          path: 'site'
          destination: 'gcs-website'
          parent: false
          gzip: false

Open an issue

If the issue you're facing is not on here, please open an issue

Link to open an issue