Container Tools for Visual Studio Code: Extensibility Model

Overview

This package provides the necessary interfaces to implement a registry provider for the Container Tools extension for Visual Studio Code. Additionally, it also contains an implementation of a registry provider for the common Docker Registry HTTP API V2. Most implementations will be a fairly slim inheriting implementation of this.

In order to implement a provider, you must create a VS Code extension which will activate when the Container Explorer view is opened, and register itself with the Container Tools extension. The Container Tools extension will call into your provider to discover what nodes to show in the explorer view.

When to implement a registry provider extension

You should implement a registry provider extension if:
1. Your registry has advanced authentication (e.g. OAuth, etc.)
1. Your registry has a nonstandard API
1. Your registry has advanced features, beyond the basic image storage functionality

You should _not_ implement a registry provider extension if:
1. Your registry can be connected to already with the generic V2 provider
- If only very minor changes are needed in the generic V2 provider to support your registry, please file an issue or submit a pull request instead
1. There is already an extension for your registry

How to implement a registry provider extension

1. Create a new VS Code extension. Learn more
1. Add the following activation event to your extension's package.json: onCommand:vscode-containers.activateRegistryProviders. Learn more
1. Implement the RegistryDataProvider interface. The easiest way to do this is to extend either CommonRegistryDataProvider or, if your registry is compliant to the V2 registry spec, RegistryV2DataProvider.
1. In your extension's activate() method, call into the Container Tools extension to register your provider. Learn more

License

MIT

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct.
For more information see the Code of Conduct FAQ or
contact opencode@microsoft.com with any additional questions or comments.