Skip to content
Azure provider for Gyro cloud automation tool.
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples
gradle/wrapper
src/main/java/gyro/azure
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
build.gradle
gradle.properties
gradlew
gradlew.bat
settings.gradle

README.md

Gitter TravisCI Apache License 2.0

The Azure Provider for Gyro enables users to easily work with Microsoft Azure Services. The Azure provider extends Gyro allowing you to manage your Azure infrastructure.

To learn more about Gyro see getgyro.io and gyro.

Using the Azure Provider

Azure Account

Before you can use Azure provider, you will need an Azure account. Please see Sign Up for Azure to create an Azure Account.

Once your account is set up and ready to be used, you need to set up an Azure service principal and save the credentials in a file in the following format

# sample management library properties file
subscription=########-####-####-####-############
client=########-####-####-####-############
key=XXXXXXXXXXXXXXXX
tenant=########-####-####-####-############
managementURI=https\://management.core.windows.net/
baseURL=https\://management.azure.com/
authURL=https\://login.windows.net/
graphURL=https\://graph.windows.net/

For more info refer Azure file based authentication and Setting up Azure credentials for Gyro.

Using The Provider

Import

Load the Azure provider in your project by consuming it as a plugin directive in your init file. It uses the format @plugin: gyro:gyro-azure-provider:<version>.

@repository: 'https://artifactory.psdops.com/gyro-releases'
@plugin: 'gyro:gyro-azure-provider:0.99.0'

Authentication

Provide the Azure provider with the path of the credentials file by defining the following in your .gyro/init.gyro file:

@credentials 'azure::credentials'
    log-level: 'basic'
    region: 'westus'
    credential-file-path: '<azure_credentials_file_path>'
@end

See Azure authentication for Gyro for more details.

Supported Services

Developing the Azure Provider

The provider is written in Java using Gradle as the build tool.

We recommend installing AdoptOpenJDK 11 or higher if you're going to contribute to this provider.

Gyro uses the Gradle build tool. Once you have a JDK installed building is easy, just run ./gradlew at the root of the Gyro project. This wrapper script will automatically download and install Gradle for you, then build the provider:

$ ./gradlew
Downloading https://services.gradle.org/distributions/gradle-5.2.1-all.zip
..............................................................................................................................

Welcome to Gradle 5.2.1!

Here are the highlights of this release:
 - Define sets of dependencies that work together with Java Platform plugin
 - New C++ plugins with dependency management built-in
 - New C++ project types for gradle init
 - Service injection into plugins and project extensions

For more details see https://docs.gradle.org/5.2.1/release-notes.html

Starting a Gradle Daemon, 1 stopped Daemon could not be reused, use --status for details

.
.
.

BUILD SUCCESSFUL in 17s
38 actionable tasks: 28 executed, 10 from cache
$

Getting Help

  • Join the Gyro community chat on Gitter.
  • Take a look at the documentation for tutorial and examples.

License

This software is open source under the Apache License 2.0.

You can’t perform that action at this time.