Azure / azure-cli-extensions

Extensions for Azure CLI 2.0 This repository serves two purposes and they are independent: • A source code directory, , to host your extension source code. • An index.json where you can add your extension and make it available through Azure CLI. For documentation on authoring an extension, see Extension Documentation About index.json • The index is at . • Modify the index by creating a PR. • All extensions added to the index *are public* and will be available to *all* CLI users. • The index is synced to every few minutes. • Your extension source code does not have to be in this repository to be available in the index. • If you don't want your extension to be part of the index, you can still host it externally and request users to install with . • Users will not be able to add your extension by name, it will not be listed in the command and to update to a new version of your extension, the user has to first remove the currently installed extension and then add the new version. Add your extension to the index to make it available in these CLI commands: • - Allows users to add an extension by name • - Allows users to list the available extensions in the index • - Allows users to update an extension About source code in this repository • Extension source code goes into the directory. • You can place your source code in this repository by creating a PR. • Once CI is green and it has been approved, the PR can be merged. • SDKs generated from AutoRest often do not pass CI static-checking. If they are vendored inside the extension, exclude them from static checking by placing them in the folder: . • Ensure that you include an appropriate owner for your extension in . • Your extension artifact (i.e. ) will not live in this repository. You can publish your extension to PyPI or somewhere else such as Azure Storage. • If you want your extension to appear in the index.json, modify the index. About extension publishing There is a pipeline to automatically build, upload and publish extension wheels. Once your PR is merged into master branch, a new PR will be created to update automatically. The precondition is to put your code inside this repo and upgrade the version in the PR but not to modify . If you want to host the source code in your dedicated repo, you have to upload the WHL file and update the manually. For detail, please visit Publish section in Azure CLI Extension Authoring. FAQ How to generate sha256digest for an index.json entry? If you use the command will calculate the SHA256 digest for you. For more information visit https://github.com/Azure/azure-cli-dev-tools. As a fallback: MacOS Windows / PowerShell Note: Hash should be in lowercase in index.json otherwise CI will fail. How to fill in the metadata for an index.json entry? The command can be used to simplify the process of updating the index file. Run where URL is the fully-qualified URL to your published extension WHL. This will gather the appropriate metadata and add an entry for your extension to the index. For more information visit https://github.com/Azure/azure-cli-dev-tools. As a fallback: The metadata needed to be filled is a combination of the contents present in: • located in your unzipped extension artifact ( file) in the directory. This metadata is garnered from the folder. • (if it exists) under your extension. Note that CI will fail if this metadata does not match the contents of your published extension. 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.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., label, 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.