Troubleshoot DataSurface Authentication

Diagnose and fix DataSurface Docker and PyPI authentication failures across environments.

2|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/datasurface/demo1 --skill troubleshoot-datasurface-authentication-datasurface
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Troubleshoot DataSurface Authentication
Source: https://github.com/datasurface/demo1/tree/main/.claude/skills/troubleshoot-datasurface-auth
Command: npx skills add https://github.com/datasurface/demo1 --skill troubleshoot-datasurface-authentication-datasurface

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose and fix authentication failures when accessing DataSurface Docker images and PyPI packages.

Core Features & Use Cases

  • Provide authenticated access verification for Docker registries and PyPI packages, including common failure modes.
  • Support multi-environment troubleshooting across local Docker, CI/CD pipelines, and Kubernetes deployments.
  • Use Case: In a failing build, verify credentials, test login commands, and reconfigure secrets to restore access quickly.

Quick Start

Run the quick-start steps to reproduce and remediate common authentication issues. For example, test docker login registry.gitlab.com -u "$GITLAB_CUSTOMER_USER" -p "$GITLAB_CUSTOMER_TOKEN" and pip index versions datasurface --index-url "https://${DATASURFACE_USER}:${DATASURFACE_TOKEN}@gitlab.com/api/v4/projects/77796931/packages/pypi/simple".

Frequently Asked Questions about Troubleshoot DataSurface Authentication

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

FAQPage Schema
How do I fix DataSurface Docker registry authentication failures?

To fix DataSurface Docker registry authentication failures, test your login command using the correct GitLab customer user and token credentials. This verifies credential validity and prescribes remediation steps to restore authenticated access to private Docker images.

Why does pip fail to install private PyPI packages from DataSurface?

PyPI package installations fail when the pip index URL lacks valid DataSurface user and token credentials. Diagnose the authentication failure by verifying your access token and testing the configured index URL endpoint directly.

Can I troubleshoot DataSurface access issues across Kubernetes and CI/CD pipelines?

Yes, you can troubleshoot DataSurface access issues across local Docker, CI/CD pipelines, and Kubernetes deployments. The diagnostic process tests credential validity and prescribes reconfiguration steps to restore authenticated access in any environment.

What is the best way to diagnose DataSurface credential validity?

The best way to diagnose DataSurface credential validity is to run enforced access tests for Docker login and PyPI package retrieval. This identifies common failure modes and provides exact remediation steps to reconfigure secrets.

Why is my DataSurface build failing to pull private assets?

Your build fails to pull private assets due to invalid registry or PyPI credentials. Diagnose the authentication failure by testing your GitLab token configuration and applying the prescribed remediation steps to restore access quickly.

Do I need specific environment variables to authenticate DataSurface packages?

Yes, you need environment variables like GITLAB_CUSTOMER_USER, GITLAB_CUSTOMER_TOKEN, DATASURFACE_USER, and DATASURFACE_TOKEN to authenticate. These credentials are tested during diagnosis to verify access to private Docker and PyPI assets.