Wondering what’s next for npm?Check out our public roadmap! »

    This package has been deprecated

    Author message:

    The Azure Building Blocks project will not be undergoing further development. For advanced deployment template capabilities refer to Bicep (https://aka.ms/bicep), Azure Resource Manager template specs (https://aka.ms/templatespecs) and the Azure Resource Manager template documentation (https://aka.ms/arm-template-docs). New development should not leverage Azure Building Blocks.

    @mspnp/azure-building-blocks

    2.2.4 • Public • Published

    Azure Building Blocks       Azure Building Blocks

    Azure Building Blocks: Simplifying Resource Deployment

    Build status npm version

    Important: The Azure Building Blocks project will not be undergoing further development. For advanced deployment template capabilities refer to Bicep, Azure Resource Manager template specs and the Azure Resource Manager template documentation. New development should not leverage Azure Building Blocks.

    Note: Version 2.1.1 of Azure Building Blocks introduced breaking changes to versions earlier than 2.0.4. Versions earlier than 2.0.4 will no longer function. Please upgrade to version 2.0.4 or greater to continue using Azure Building Blocks.

    The Azure Building Blocks project is a command line tool and set of Azure Resource Manager templates designed to simplify deployment of Azure resources. Users author a set of simplified parameters to specify settings for Azure resources, and the command line tool merges these parameters with best practice defaults to produce a set of final parameter files that can be deployed with the Azure Resource Manager templates.

    Getting Started

    Install the Azure Building Blocks using npm:

    npm install -g @mspnp/azure-building-blocks
    

    Verify the version of azure building blocks you are running using the command below. Make sure you are running version 2.0.4 or later.

    azbb -V
    

    Then, author an Azure Building Blocks parameter file and run the azbb command line tool.

    Documentation

    Full documentation for the command line tool and parameter file schema is available on the Wiki.

    Examples

    Azure Building Blocks parameters to deploy three identical VMs:

    "type": "VirtualMachine",
    "settings": {
        "vmCount": 3,
        "osType": "windows",
        "namePrefix": "test",
        "adminPassword": "testPassw0rd!23",
        "nics": [{"subnetName": "web"}],
        "virtualNetwork": {"name": "ra-vnet"}
    }

    The command line tool merges best practice defaults to the parameters as follows:

    • Enables diagnostics on all VMs
    • Deploys the VMs in an availability set
    • All VM disks are managed
    • OS is latest Windows Server 2016 image
    • Public IP created for each VM

    To add a scaleset with three identical VMs:

    "type": "VirtualMachine",
    "settings": {
        "vmCount": 3,
        "osType": "windows",
        "namePrefix": "test",
        "adminPassword": "testPassw0rd!23",
        "nics": [{
            "subnetName": "web",
            "isPublic": false
            }],
        "virtualNetwork": {"name": "ra-vnet"},
        "scaleSetSettings": { }
    }

    Version history

    The list below shows changes introduced with the latest versions.

    2.0.4

    • Fixed minor bugs
    • Introduced a more rigorous versioning scheme

    2.1.1

    • Introduced breaking changes to versions less than 2.0.4
    • Added standalone load balancer building block
    • Added standalone application gateway building block
    • Changes to VM building block to allow use of pre-existing load balancer and application gateway
    • Added support for 'single-step' disk encryption to VM building block

    2.1.2

    • Fixed bug on internal load balancer
    • Added support for 'custom data' to VM building block

    2.2.0

    • Added support for Availability Zones and Standard SKU for Load Balancers, Application Gateways, and Public IP Addresses
    • Added support for Availability Zones for virtual machines
    • Added deployment script generation
    • Added NodeJS 10.16.2+ requirement

    2.2.1

    • Added missing subscription parameter

    2.2.2

    • Fixed AZ CLI parameter issues

    2.2.3

    • Fixed Azure Cloud Shell incompatibility

    2.2.4

    • Added lifecycle warnings

    License

    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.

    Install

    npm i @mspnp/azure-building-blocks

    DownloadsWeekly Downloads

    40

    Version

    2.2.4

    License

    MIT

    Unpacked Size

    2.21 MB

    Total Files

    180

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar