Files
ado-sk-toolkit-extension/README.md

1.6 KiB

SK Azure DevOps Toolkit

Developer README for the Azure DevOps extension codebase.

For administrator-facing installation and usage guidance, see overview.md.

Tasks in this extension

  • AzureFederatedAuth@1
    • Requests an OIDC token for a selected AzureRM service connection (workload identity federation).
    • Exports:
      • ARM_OIDC_TOKEN (secret)
      • ARM_TENANT_ID
      • ARM_CLIENT_ID
      • GIT_ACCESS_TOKEN (secret, optional)
  • CopyBlob@1
    • Copies a blob between Azure Storage accounts/containers using the selected AzureRM service connection.

Repository layout

  • task/AzureFederatedAuth - task implementation and manifest
  • task/CopyBlob - task implementation and manifest
  • task/_shared - shared OIDC/auth helpers used by tasks
  • scripts/build.sh - builds tasks and packages the extension
  • examples/azure-pipelines-smoke.yml - smoke pipeline example

Local development

Prerequisites:

  • Node.js (LTS)
  • npm

Install dependencies (per task):

cd task/AzureFederatedAuth && npm install
cd ../CopyBlob && npm install

Build and package extension:

./scripts/build.sh

Build output:

  • Task JavaScript output in each task's dist/
  • Extension package (.vsix) in build/

Validation pipeline

Use examples/azure-pipelines-smoke.yml to validate task execution end-to-end in Azure Pipelines.

Publishing notes (maintainers)

Publishing requires a Visual Studio Marketplace publisher and sharing the published extension with target Azure DevOps organizations.

Author

Slawomir Koszewski

License

MIT. See LICENSE.