{
  "id": "cicd/docker-credential-helper-not-configured",
  "signature": "Error: credential helper 'desktop' is not installed or not configured. Run 'docker login' to configure credentials.",
  "signature_zh": "错误：凭据助手 'desktop' 未安装或未配置。运行 'docker login' 来配置凭据。",
  "regex": "credential helper.*is not installed or not configured",
  "domain": "cicd",
  "category": "auth_error",
  "subcategory": null,
  "root_cause": "Docker credential helper (e.g., desktop, ecr-login) is not installed or configured in the CI environment, preventing authentication to private registries.",
  "root_cause_type": "generic",
  "root_cause_zh": "Docker 凭据助手（例如 desktop、ecr-login）未在 CI 环境中安装或配置，导致无法向私有注册表进行身份验证。",
  "versions": [
    {
      "version": "Docker 24.0.5",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Docker Desktop 4.22.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Amazon ECR Docker Credential Helper 0.7.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Running docker login without specifying the credential store may still fail if the helper path is missing.",
      "fail_rate": 0.4,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Setting DOCKER_CONFIG to a non-existent path can break other Docker commands.",
      "fail_rate": 0.3,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Install the credential helper: For Docker Desktop on Linux, run: sudo apt-get install docker-credential-desktop. Then verify: docker-credential-desktop list. Alternatively, use the 'pass' credential store.",
      "success_rate": 0.9,
      "how": "Install the credential helper: For Docker Desktop on Linux, run: sudo apt-get install docker-credential-desktop. Then verify: docker-credential-desktop list. Alternatively, use the 'pass' credential store.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Disable credential helpers temporarily by setting the config to store credentials in plain text (not recommended for production): echo '{\"credsStore\":\"\"}' > ~/.docker/config.json && docker login",
      "success_rate": 0.8,
      "how": "Disable credential helpers temporarily by setting the config to store credentials in plain text (not recommended for production): echo '{\"credsStore\":\"\"}' > ~/.docker/config.json && docker login",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Install the credential helper: For Docker Desktop on Linux, run: sudo apt-get install docker-credential-desktop. Then verify: docker-credential-desktop list. Alternatively, use the 'pass' credential store.",
    "Disable credential helpers temporarily by setting the config to store credentials in plain text (not recommended for production): echo '{\"credsStore\":\"\"}' > ~/.docker/config.json && docker login"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.docker.com/engine/reference/commandline/login/#credential-stores",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.82,
  "fix_success_rate": 0.85,
  "resolvable": "true",
  "first_seen": "2023-11-12",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}