equelin / PSDeploy-vSphereOVF-Recipes

Library of recipes for deploying OVF/OVA appliances with PSDeploy

PSDeploy-vSphereOVF-Recipes

Library of PSDeploy recipes for deploying OVF/OVA appliances.

What is PSDeploy?

As stated by Warren F. (Author of the module)

PSDeploy is a quick and dirty module to simplify PowerShell based deployments.

PSDeploy allow you to write simple recipes to deploy all kind of stuff like files, tasks or OVF/OVA appliances. Recipes are written in a human-readable DSL style (Domain Specific language) and can be easily modified for your needs.

Even if the recipes are quiet self explanatory, reading the PSDeploy documentation might be a good idea !

A simple recipe for deploying a OVF/OVA would look like this:

Deploy 'MyDeploy' {
    By vSphereOVF {
        FromSource 'F:\MyOVA.ova'
        To 'esxi.example.com'
        Tagged 'Prod'
        WithOptions @{
            Name = 'MYVM'
            Datastore = 'DATASTORE01'
            OvfConfiguration = @{
                'NetworkMapping.VM Network' = 'Production'
            }
            PowerOn = $true
        }
    }
}

Organization of this repository

Recipes are stored in subfolders of this repository. There is a different folder for each editors, products and versions. You will find in the folder Tools some script used to create the recipes.

Requirements

• VMware PowerCLI
• PSDeploy

Instructions

• If not already done, install all the needed requirements
• Browse the subfolders of this repository to find the recipe you are looking for
• Grab a copy of the recipe and store it on your computer

Don't forget to name your file like this: MyFile.psdeploy.ps1

• Change the parameters as needed
• Open a powercli console
• Log in to a vCenter Server or ESX host with the command Connect-VIServer
• Load the PSDeploy module

Import-Module PSDeploy

• Run the Invoke-PSDeploy to start the deployment of our OVF/OVA

Invoke-PSDeploy -Path 'MyFile.psdeploy.ps1'

• Enjoy !

Author

Erwan Quélin

• https://github.com/equelin
• https://twitter.com/erwanquelin

Special Thanks

• Warren F. (author of PSDeploy) - Blog - Twitter - GitHub
• William Lam - Blog - Twitter - GitHub
• Alan Renouf - Blog - Twitter - GitHub

License

Copyright 2016 Erwan Quelin.

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.