nanomsg-role

An ansible role for nanomsg

Input Variables

• Name
  • nanomsg_role_nanomsg_version
• Value
  • The version of nanomsg to install. Defaults to "1.0.0"
• Usage

  nanomsg_role_nanomsg_version: "1.0.0"

Ansible Role Development with Vagrant

Requirements

• Install Vagrant >= 2.0.0 flavor for you host operating system.
• Install the vagrant-env vagrant plugin. A vagrant plugin to load environment variables from .env into ENV

  vagrant plugin install vagrant-env

• Default virtualization is configured with VirtualBox.
  • Download VirtualBox.
  • Install VirtualBox for your host operating system.
  • Install the vagrant-vbguest vagrant plugin. A Vagrant plugin to keep your VirtualBox Guest Additions up to date.

    vagrant plugin install vagrant-vbguest

• If deploying to Azure, install the vagrant-azure vagrant plugin. A Vagrant plugin to enable Vagrant to manage virtual machines in Microsoft Azure.

  vagrant plugin install vagrant-azure

Getting Started

• Copy sample.env and make a local environment script .env.

  Note: *.env is present in the .gitignore file, with the explicit exception for sample.env.

  # bash
  cp ./sample.env ./.env
  
  # windows
  copy sample.env .env

• Update .env with your own settings.
  • Ensure you have your personal public and private RSA keypair located ~/.ssh/id_rsa. Otherwise update the RSA_PUB_KEY variable in this file to point to the correct path for your key pair. We you do not have or use an RSA key pair for security you can [follow these simple instructions](https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/.

Local Ansible Role Development

• This project is setup as a multi-machine vagrant environment. If you are new to this project start by viewing the configured vagrant vms.

  vagrant status

• You can optionally check the status of a specific vm instance

  vagrant status vbox-ubuntu-16.04
  
  # or 
  
  vagrant status azure-ubuntu-16.04

Local Ansible Role Development with Vagrant/VirtualBox

• Create and provision an image. Provisioning will provision the ansible role using the ansible_local vagrant provisioner.

  vagrant up vbox-ubuntu-16.04 --provision
  
  # PLAY RECAP *********************************************************************
  # vbox-ubuntu-16.04          : ok=13   changed=8    unreachable=0    failed=0

• Connect to new vm image via ssh to diagnose any issues.

  vagrant ssh vbox-ubuntu-16.04
  
  # Poke around and then exit when finished.
  exit

• Reload the vm and reprovision with ansible role. If desired state is achieved with your role subsequent reloads should yield changed=0 results.

  vagrant reload vbox-ubuntu-16.04 --provision-with=ansible_local
  
  # PLAY RECAP *********************************************************************
  # vbox-ubuntu-16.04          : ok=6    changed=0    unreachable=0    failed=0

• Connect to the vm via ssh.

  vagrant ssh vbox-ubuntu-16.04

• Bring virtual machine to starting state. Save some space and destroy the vm.

  vagrant destroy -f vbox-ubuntu-16.04

Azure Ansible Role Development with Vagrant

• Install Azure Vagrant Plugin

  vagrant plugin install vagrant-azure --plugin-version '2.0.0.pre8'

• Add Azure Dummy Box

  vagrant box add azure https://github.com/azure/vagrant-azure/raw/v2.0/dummy.box

• You must have an App Registrant setup for your azure account, instructions. This will be needed for the next step.
• Update ./.env with your own azure values, public rsa key, azure region, etc.
• Use Vagrant to provision azure provider image.

  vagrant up azure-ubuntu-16.04 --provision
  
  # PLAY RECAP *********************************************************************
  # azure-ubuntu-16.04      : ok=13   changed=8    unreachable=0    failed=0

• Reload the vm and reprovision with ansible role. If desired state is achieved with your role subsequent reloads should yield changed=0 results.

  vagrant reload azure-ubuntu-16.04 --provision-with=ansible_local
  
  # PLAY RECAP *********************************************************************
  # azure-ubuntu-16.04      : ok=6    changed=0    unreachable=0    failed=0

• Connect to the vm via ssh.

  vagrant ssh azure-ubuntu-16.04

• Destroy existing azure image to save some fiat.

  vagrant destroy -f

• Destroy vm and .

  vagrant destroy -f

License

Bipcot 1.12

Donations Accepted:

• BTC: 1PrMDWtCCB4HutiEvFZx3X7pW3PQma3G8u
• LTC: LR2XX2KegbEBp6DTU9kPBRdPmVW8qhQafu
• KMD: RL7Dykpozn3ahJrNbG1gfq8mvWHSeyqZ2w