You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

The following steps describe the procedures to Instantiate the Azure Standalone SBC or the HA SBC with HFE using IAC:

  1. Access and Share SBC Image in Azure.
  2. Create an Ubuntu 18.04 LTS instance in Azure.
  3. Run az login and sign in as a user with the role 'owner' for the subscription.

  4. Create a Service Principal that contains 'owner' permissions for the subscription.

    Example:

    az ad sp create-for-rbac -n rbbn-iac --role="owner" --scopes="/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXa511"
    • The Service Principle created as 'owner' has sufficient privileges to create and assign roles
    • Store the relevant credentials and re-use to prevent continuous creation of Service Principals
    • The output includes credentials that you must protect

  5. Make a directory to extract the IAC tarball:

    mkdir iac_package

  6. Copy the IAC tarball to the created directory created above and change it to that directory:

    cp iac_sustaining_*.tar.gz  iac_package/
cd iac_package

  7. Extract the IAC tarball using tar.

    tar xvfz iac_sustaining_*.tar.gz

  8. To set up the IAC environment, follow the instructions available in ./iac_package/README.md

  9. Follow the Azure instructions in ./iac_package/help/REAMDE.azure.md file to create either:
    • Standalone SBC
      • To setup Standalone,  follow the instructions in ./iac_package/orchestration/azure/sbc_stand_alone/README.md
    • HA SBC with HFE
      • To setup SBC HA with HFE 2.1, follow the instructions in ./iac_package/orchestration/azure/sbc_hfe2.1/README.md
      • Create a HFE Storage Account to store the HFE_AZ.sh script 
  10. For either Standalone or HA with HFE, update the "terraform.tfvars" to provide inputs for deployment. Update the following:
    1. resource_group_names
    2. resource_group_locations
    3. hfe_script_url
    4. remote_ssh_ip
    5. address_prefix_pkt0Src
    6. address_prefix_pkt1Src
    7. image_name

  11. Export the following environment variables, stored from the Service Principal creation:

    export ARM_SUBSCRIPTION_ID="<subscription_id>"
export ARM_TENANT_ID="<tenant_id>"
export ARM_CLIENT_ID="<client_id>"
export ARM_CLIENT_SECRET="<client_secret>"
  12. Use the Terraform commands mentioned below:

    1. Initialize Terraform:

      terraform init

    2. Run Terraform plan command, to preview the changes and ensure that "terraform.tfvars" are configured correctly before applying:

      terraform plan

    3. Apply the resource configuration:

      terraform apply

      Ensure to create resources according to deployment needs.

      For Standalone SBC, make a note of the following field:

      • SBC public IP: sbc_public_ip

      For the HA SBC with HFE setup, make a note of the following fields:

      • Active SBC public IP: active_sbc_public_ip
      • Standby SBC public IP: standby_sbc_public_ip

  13. To destroy all SBC resources from Microsoft Azure:

    terraform destroy
  • No labels