Azure
/
vagrant-azure
зеркало из https://github.com/Azure/vagrant-azure.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность

Merge pull request #114 from devigned/chore/version 

update the readme and the version to preview
This commit is contained in:
David Justice 2016-04-07 15:38:26 -07:00
Родитель 845d43c093 54f78936de
Коммит 44a3b0b8c6
2 изменённых файлов: 37 добавлений и 179 удалений
Показать статистику Скачать Patch файл Скачать Diff файл Показать все файлы Свернуть все файлы

214
README.md
Просмотреть файл

@ -12,7 +12,7 @@ Install Vagrant 1.7.3 or higher - [Download Vagrant](http://www.vagrantup.com/do
Install the vagrant-azure plugin using the standard Vagrant 1.1+ installation methods. After installing the plugin, you can ```vagrant up``` and use ```azure``` provider. For example: Install the vagrant-azure plugin using the standard Vagrant 1.1+ installation methods. After installing the plugin, you can ```vagrant up``` and use ```azure``` provider. For example:
``` ```
C:\> vagrant plugin install vagrant-azure C:\> vagrant plugin install vagrant-azure 2.0.0.pre1
... ...
C:\> vagrant up --provider=azure C:\> vagrant up --provider=azure
... ...
@ -25,7 +25,7 @@ You'll need an ```azure``` box before you can do ```vagrant up``` though.
You can use the dummy box and specify all the required details manually in the ```config.vm.provider``` block in your ```Vagrantfile```. Add the dummy box with the name you want: You can use the dummy box and specify all the required details manually in the ```config.vm.provider``` block in your ```Vagrantfile```. Add the dummy box with the name you want:
``` ```
C:\> vagrant box add azure https://github.com/msopentech/vagrant-azure/raw/master/dummy.box C:\> vagrant box add azure https://github.com/azure/vagrant-azure/raw/v2.0/dummy.box
... ...
``` ```
@ -33,37 +33,22 @@ Now edit your ```Vagrantfile``` as shown below and provide all the values as exp
```ruby ```ruby
Vagrant.configure('2') do |config| Vagrant.configure('2') do |config|
config.vm.box = 'azure' config.vm.box = 'azure'
config.vm.provider :azure do |azure, override| # use local ssh key to connect to remote vagrant box
# Mandatory Settings config.ssh.private_key_path = '~/.ssh/id_rsa'
azure.mgmt_certificate = 'YOUR AZURE MANAGEMENT CERTIFICATE' config.vm.provider :azure do |azure, override|
azure.mgmt_endpoint = 'https://management.core.windows.net'
azure.subscription_id = 'YOUR AZURE SUBSCRIPTION ID' # use Azure Active Directory Application / Service Principal to connect to Azure
azure.vm_image = 'NAME OF THE IMAGE TO USE' # see: https://azure.microsoft.com/en-us/documentation/articles/resource-group-create-service-principal-portal/
azure.vm_name = 'PROVIDE A NAME FOR YOUR VIRTUAL MACHINE' # max 15 characters. contains letters, number and hyphens. Can start with letters and can end with letters and numbers. May NOT contain underscores "_"
# each of the below values will default to use the env vars named as below if not specified explicitly
# vm_password is optional when specifying the private_key_file with Linux VMs azure.tenant_id = ENV['AZURE_TENANT_ID']
# When building a Windows VM and using WinRM this setting is used to authenticate via WinRM (PowerShell Remoting) azure.client_id = ENV['AZURE_CLIENT_ID']
azure.vm_password = 'PROVIDE A VALID PASSWORD' # min 8 characters. should contain a lower case letter, an uppercase letter, a number and a special character azure.client_secret = ENV['AZURE_CLIENT_SECRET']
azure.subscription_id = ENV['AZURE_SUBSCRIPTION_ID']
# Optional Settings end
azure.storage_acct_name = 'NAME OF YOUR STORAGE ACCOUNT' # optional. A new one will be generated if not provided.
azure.vm_user = 'PROVIDE A USERNAME' # defaults to 'vagrant' if not provided
azure.cloud_service_name = 'PROVIDE A NAME FOR YOUR CLOUD SERVICE' # same as vm_name. leave blank to auto-generate
azure.deployment_name = 'PROVIDE A NAME FOR YOUR DEPLOYMENT' # defaults to cloud_service_name
azure.vm_location = 'PROVIDE A LOCATION FOR VM' # e.g., West US
# Optional *Nix Settings
azure.ssh_port = 'A VALID PUBLIC PORT' # defaults to 22
azure.private_key_file = 'Path to your ssh private key file (~/.ssh/id_rsa) to use for passwordless auth. If the id_rsa file is password protected, you will be prompted for the password.'
# Optional Windows Settings
azure.winrm_transport = [ 'http', 'https' ] # this will open up winrm ports on both http (5985) and http (5986) ports
azure.winrm_https_port = 'A VALID PUBLIC PORT' # customize the winrm https port, instead of 5986
azure.winrm_http_port = 'A VALID PUBLIC PORT' # customize the winrm http port, insted of 5985
azure.tcp_endpoints = '3389:53389' # opens the Remote Desktop internal port that listens on public port 53389. Without this, you cannot RDP to a Windows VM.
end
end end
``` ```
@ -77,11 +62,11 @@ This will bring up an Azure VM as per the configuration options set above.
You can now either SSH (if its a *Nix VM) using ```vagrant ssh```, RDP (if its a Windows VM) using ```vagrant rdp``` or PowerShell ```vagrant powershell```. You can now either SSH (if its a *Nix VM) using ```vagrant ssh```, RDP (if its a Windows VM) using ```vagrant rdp``` or PowerShell ```vagrant powershell```.
Normally, a lot of this options, e.g., ```vm_image```, will be embedded in a box file and you just have to provide minimal options in the ```Vagrantfile```. Since, we're using a dummy box, there are no pre-configured defaults. Normally, a lot of this options, e.g., ```vm_image_urn```, will be embedded in a box file and you just have to provide minimal options in the ```Vagrantfile```. Since, we're using a dummy box, there are no pre-configured defaults.
## Azure Boxes ## Azure Boxes
The vagrant-azure plugin provides the ability to use ```Azure``` boxes with Vagrant. Please see the example box provided in [example_box/ directory](https://github.com/msopentech/vagrant-azure/tree/master/example_box) and follow the instructions there to build an ```azure``` box. The vagrant-azure plugin provides the ability to use ```Azure``` boxes with Vagrant. Please see the example box provided in [example_box/ directory](https://github.com/azure/vagrant-azure/tree/v2.0/example_box) and follow the instructions there to build an ```azure``` box.
Please see [Vagrant Docs](http://docs.vagrantup.com/v2/) for more details. Please see [Vagrant Docs](http://docs.vagrantup.com/v2/) for more details.
@ -91,148 +76,21 @@ The vagrant-azure provide exposes a few Azure specific configuration options:
### Mandatory ### Mandatory
* `mgmt_certificate` - Your Azure Management certificate which has been uploaded to the Azure portal for your account. Provide [PEM file path](#pem-generation), PFX file path or raw string. For instructions on how to setup an Azure Active Directory Application see: https://azure.microsoft.com/en-us/documentation/articles/resource-group-create-service-principal-portal/
* `mgmt_endpoint` - Azure Management endpoint. `https://management.core.windows.net` * `tenant_id`: Your Azure Active Directory Tenant Id.
* `subscription_id` - Your Azure Subscription ID. * `client_id`: Your Azure Active Directory application client id.
* `storage_acct_name` - The Storage account to use when creating VMs. * `client_secret`: Your Azure Active Directory application client secret.
* `vm_name` - The name of the created VM. * `subscription_id`: The Azure subscription Id you'd like to use.
### Optional ### Optional
* `resource_group_name`: (Optional) Name of the resource group to use.
* `vm_user` - The username to create the VM with. Defaults to `vagrant`. * `location`: (Optional) Azure location to build the VM -- defaults to 'westus'
* `vm_password` - The password to set for the user created with the VM. This will override the private_key_file setting. * `vm_name`: (Optional) Name of the virtual machine
* `vm_image` - The name of the image to be used when creating the VM. * `vm_password`: (Optional for *nix) Password for the VM -- This is not recommended for *nix deployments
* `vm_size` - The size of the created VM. Use an of the Azure VM Sizes. * `vm_size`: (Optional) VM size to be used -- defaults to 'Standard_D1'. See: https://azure.microsoft.com/en-us/documentation/articles/virtual-machines-linux-sizes/
* `vm_virtual_network_name` - The name of a virtual network to connect to * `vm_image_urn`: (Optional) Name of the virtual machine image urn to use -- defaults to 'canonical:ubuntuserver:16.04.0-DAILY-LTS:latest'. See: https://azure.microsoft.com/en-us/documentation/articles/virtual-machines-linux-cli-ps-findimage/
* `cloud_service_name` - The name of the cloud service under which to create the VM. * `virtual_network_name`: (Optional) Name of the virtual network resource
* `deployment_name` - The name to give the deployment in the cloud service and add the VM to. * `subnet_name`: (Optional) Name of the virtual network subnet resource
* `vm_location` - The location to create the cloud service, storage account. * `instance_ready_timeout`: (Optional) The timeout to wait for an instance to become ready -- default 120 seconds.
* `private_key_file` - The private key file to use for SSH (~/.ssh/id_rsa) or a [PEM file](#pem-generation). * `instance_check_interval`: (Optional) The interval to wait for checking an instance's state -- default 2 seconds.
* `ssh_port` - To map the internal SSH port 22 to a different public port. * `endpoint`: (Optional) The Azure Management API endpoint -- default 'https://management.azure.com' seconds -- ENV['AZURE_MANAGEMENT_ENDPOINT'].
* `winrm_transport` - Enables or disables WinRm. Allowed values are `http` and `https`.
* `winrm_https_port` To map the internal WinRM https port 5986 to a different public port. Must be non-empty.
* `winrm_http_port` To map the internal WinRM http port 5985 to a different public port. Must be non-empty.
* `tcp_endpoints` - To open any additional ports. E.g., `80` opens port `80` and `80,3389:53389` opens port `80` and `3389`. Also maps the interal port `3389` to public port `53389`
### Certificate Generation on Windows
We will use `makecert.exe` distributed as part of the in the Windows 7 SDK. The following commands will create the required certificate and insert it into the current user’s personal store.
```
makecert.exe -r -pe -a sha1 -n "CN=AzCert" -ss My -sr CurrentUser -len 2048 -sky exchange -sp "Microsoft Enhanced RSA and AES Cryptographic Provider" -sy 24
```
(In order to have more details with images in Windows)[http://blogs.msdn.com/b/cclayton/archive/2012/03/21/windows-azure-and-x509-certificates.aspx]
### Get Started with Publish Settings
To create a pfx from the publishsettings, simply download the publishsettings file for your subscription
[https://manage.windowsazure.com/publishsettings](https://manage.windowsazure.com/publishsettings/index?client=powershell). Make sure you have the [Ruby Azure](https://rubygems.org/gems/azure/versions/0.7.0) gem installed and run `pfxer transform --in [path to your .publishsettings file]`. This will create a .pfx from your publish settings file which can be supplied as a cert parameter for Service Management Commands.
### Get Started with OpenSSL
* Using the following openssl commands to create a cert and upload to Azure Management
* Generate public and private `openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout cert.pem -out cert.pem`
* Generate public .cer for Azure upload `openssl x509 -inform pem -in cert.pem -outform der -out mgmt.cer`
* Upload the `mgmt.cer` to Azure Management through [https://management.azure.com](https://management.azure.com)
* Use cert.pem as your cert parameter for Service Management Commands.
### Using your .pem certificate
Vagrant-Azure expects you to use a .pem management certificate as shown below:
```ruby
Vagrant.configure('2') do |config|
config.vm.box = 'azure'
config.vm.provider :azure do |azure|
azure.mgmt_certificate = "#{file_location_of_your_dot_pem}"
```
## Create Virtual Network
In order to use vagrant-azure's `vm_virtual_network_name` support, create virtual networks using
[Azure's Command Line Interface](http://azure.microsoft.com/en-us/documentation/articles/virtual-machines-command-line-tools/):
azure account download
azure network vnet create --vnet "vnet-name" --location "West US" --create-new-affinity-group
## New Commands for `azure` provider
The `azure` provider introduces the following new `vagrant` commands.
* `rdp` - To connect to a Windows VM using RDP. E.g.,
* `powershell` - To execute remote powershell commands on a Windows VM using WinRM.
```
> vagrant up --provider=azure
...
> vagrant rdp
...
> vagrant powershell
```
## Multi Machine
The options for multi machines are similar to Vagrant, please refer to the vagrant doc at http://docs.vagrantup.com/v2/multi-machine/index.html
Example Multi Machine Vagrantfile (for building out 3 Windows Virtual Machines)
```ruby
Vagrant.configure('2') do |config|
config.vm.boot_timeout = 1000
do_common_azure_stuff = Proc.new do |azure, override|
override.config.vm.box = 'azure'
azure.mgmt_certificate = 'YOUR AZURE MANAGEMENT CERTIFICATE'
azure.mgmt_endpoint = 'https://management.core.windows.net'
azure.subscription_id = 'YOUR AZURE SUBSCRIPTION ID'
azure.storage_acct_name = 'NAME OF YOUR STORAGE ACCOUNT' # optional. A new one will be generated if not provided.
azure.vm_image = 'NAME OF THE IMAGE TO USE'
azure.vm_user = 'PROVIDE A USERNAME' # defaults to 'vagrant' if not provided
azure.vm_password = 'PROVIDE A VALID PASSWORD' # min 8 characters. should contain a lower case letter, an uppercase letter, a number and a special character
azure.vm_name = 'PROVIDE A NAME FOR YOUR VIRTUAL MACHINE' # max 15 characters. contains letters, number and hyphens. can start with letters and can end with letters and numbers
azure.cloud_service_name = 'PROVIDE A NAME FOR YOUR CLOUD SERVICE' # same as vm_name. leave blank to auto-generate
azure.deployment_name = 'PROVIDE A NAME FOR YOUR DEPLOYMENT' # defaults to cloud_service_name
azure.vm_location = 'PROVIDE A LOCATION FOR VM' # e.g., West US
azure.winrm_transport = %w(https)
end
config.vm.define 'first' do |cfg|
cfg.vm.provider :azure do |azure, override|
do_common_azure_stuff.call azure, override
azure.vm_name = 'PROVIDE A NAME FOR YOUR VIRTUAL MACHINE'
azure.tcp_endpoints = '3389:53389' # opens the Remote Desktop internal port that listens on public port 53389. Without this, you cannot RDP to a Windows VM.
azure.winrm_https_port = 5986
end
end
config.vm.define 'second' do |cfg|
cfg.vm.provider :azure do |azure, override|
do_common_azure_stuff.call azure, override
azure.vm_name = 'PROVIDE A NAME FOR YOUR VIRTUAL MACHINE'
azure.tcp_endpoints = '3389:53390'
azure.winrm_https_port = 5987
end
end
config.vm.define 'third' do |cfg|
cfg.vm.provider :azure do |azure, override|
do_common_azure_stuff.call azure, override
azure.vm_name = 'PROVIDE A NAME FOR YOUR VIRTUAL MACHINE'
azure.tcp_endpoints = '3389:53391'
azure.winrm_https_port = 5988
end
end
# Executes powershell on the remote machine and returns the hostname
config.vm.provision 'shell', inline: 'hostname'
end
```

2
lib/vagrant-azure/version.rb
Просмотреть файл

@ -4,6 +4,6 @@
module VagrantPlugins module VagrantPlugins
module Azure module Azure
VERSION = '2.0.0' VERSION = '2.0.0.pre1'
end end
end end