bicep-types-az

Bicep type definitions for ARM resources

Browsing available types

See /generated/index.md for a searchable list of all the available types. You can view individual type definitions by clicking on api versions.

Re-generating types from swagger

Under GitHub Actions, run the "Update Types" workflow on the main branch. Usually you'll want to leave the git ref input as "master" for this workflow.
After ~2hrs, this action will generate a PR in this repo from a branch named autogenerate.
To workaround this issue, close the PR and open it to trigger Merge Validation to run.
Merge the PR. Type differences can be reviewed by looking at the Markdown files in /generated.

Running generation locally

Initial setup

Clone this repo
Check out submodules:
```
git submodule update --init --recursive
```

Build the bicep-types dependency:

pushd bicep-types/src/bicep-types
npm ci
npm run build
popd

Ensure you have a copy of the azure-rest-api-specs repo checked out locally.

Build the autorest extension code:

cd src/autorest.bicep
npm ci
npm run build

Change to the generator directory, and install dependencies:
```
cd ../../src/generator
npm ci
```

Running

To run generation across the entire specs repo:

npm run generate -- --specs-dir {path to azure-rest-api-specs}

To run generation for a single path in the specs repo (e.g. 'compute'):

npm run generate -- --specs-dir {path to azure-rest-api-specs} --single-path compute

To see other available generation parameters, including debugging options:
```
npm run generate -- --help
```

Debugging in VSCode

Ensure you have cloned the azure-rest-api-specs repo into the same directory that you have cloned this repo - e.g. so you have the following folder structure:
```
.
./bicep-types-az
./azure-rest-api-specs
```
Use the Generate Single VSCode action, and specify a 'base path' from the specifications folder in the azure-rest-api-specs repo - e.g. compute or automation. You should now be able to step through the src/generator and src/autorest.bicep extension code with the VSCode debugger.

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.

Azure/bicep-types-az