extend-helper-cli

Last updated on November 22, 2024

Troubleshooting

This section contains troubleshooting information for possible issues you may encounter when developing an Extend app.

Docker login fails

Pushing an Extend app container image to AGS using Extend Helper CLI, the extend-helper-cli dockerlogin ... command returns the following error:

Error saving credentials: error storing credentials - err: exit status 1, out: `error storing credentials - err: exit status 1, out: `The stub received bad data.`

This issue may be due to the token size being larger than most credential managers can handle. For more information, see Docker's ticket for this issue.

The workaround for this issue depends on your operating system.

Linux

1. Remove "credsStore": "desktop.exe" from $HOME/.docker/config.json.

2. Try extend-helper-cli dockerlogin ... command again.

Windows (WSL2)

1. In Windows file system:

   • Remove "credsStore": "desktop.exe" from %USERPROFILE%\.docker\config.json.
   • Rename the following files in C:\Program Files\Docker\Docker\resources\bin.
     • docker-credential-desktop.exe to docker-credential-desktop.exe.old
     • docker-credential-wincred.exe to docker-credential-wincred.exe.old

2. In WSL2 file system:

   • Remove "credsStore": "desktop.exe" from $HOME/.docker/config.json.

3. Try extend-helper-cli dockerlogin ... command again.

注記

You may have to periodically apply this workaround. As of this article's update date, Docker has a known issue of restoring "credsStore": "desktop" in the config.json file when it is restarted. For more information, see Docker's ticket for this issue.