vagrant-aws
A Vagrant plugin that adds an AWS provider, enabling Vagrant to manage and provision EC2 and VPC instances.
What is vagrant-aws?
Vagrant AWS Provider is a plugin for Vagrant 1.2+ that extends Vagrant's capabilities to control and provision machines within Amazon Web Services (AWS) EC2 and VPC environments. It allows developers to use familiar Vagrant workflows to manage cloud infrastructure, bridging the gap between local development and cloud deployment.
Developers and DevOps engineers who use Vagrant for local development and want to manage AWS EC2 or VPC instances with the same workflow. It is particularly useful for teams needing consistent provisioning and configuration across local and cloud environments.
Developers choose this plugin because it brings Vagrant's simplicity and consistency to AWS infrastructure management, allowing them to treat cloud instances like local virtual machines. It supports multi-region configurations, instance packaging into reusable boxes, and integrates with existing Vagrant provisioners.
Overview
Use Vagrant to manage your EC2 and VPC instances.
Use Cases
Best For
- Managing AWS EC2 and VPC instances using Vagrant commands like 'vagrant up' and 'vagrant provision'.
- Provisioning cloud instances with built-in Vagrant provisioners (e.g., Shell, Puppet, Chef) for consistent deployment.
- Defining region-specific configurations to manage machines across multiple AWS regions from a single Vagrantfile.
- Packaging running AWS instances into new Vagrant boxes for reuse and distribution.
- Automatically attaching instances to Elastic Load Balancers (ELB) during boot and detaching on destroy.
- Applying custom tags and user data scripts to AWS instances during provisioning for automation and organization.
Not Ideal For
- Projects requiring advanced AWS networking setups like custom VPC routing or multiple network interfaces
- Teams needing real-time, bidirectional folder synchronization for active development without manual rsync
- Organizations that standardize on infrastructure-as-code tools like Terraform or AWS CloudFormation for all cloud resource management
- Environments where minimal overhead and direct AWS CLI or SDK usage are preferred over Vagrant's abstraction layer
Pros & Cons
Pros
Uses standard Vagrant commands like 'vagrant up' and 'vagrant provision' for AWS instances, reducing the learning curve for existing Vagrant users. The README shows integration with provider-specific configuration blocks in Vagrantfile.
Supports defining region-specific configurations within a single Vagrantfile using the region_config method, enabling easy control of instances across multiple AWS regions without separate setups.
Allows the use of any built-in Vagrant provisioner (e.g., Shell, Puppet) on AWS instances, ensuring consistent deployment scripts. The features list confirms SSH and provisioning support.
Enables packaging running instances into reusable Vagrant boxes with customizable tags via package_tags, facilitating image management and distribution as detailed in the configuration section.
Cons
Networking via config.vm.network is not supported, as admitted in the README, which restricts complex VPC setups and requires workarounds for advanced networking needs.
Only supports uni-directional folder syncing via rsync on specific commands, lacking real-time or bidirectional sync, which can be inconvenient for development workflows requiring frequent file updates.
Requires using a dummy box or custom box creation for initial setup, adding complexity compared to native AWS tools. The quick start section involves manual configuration of credentials and keys.
Frequently Asked Questions
Related Projects
cloud-custodianRules engine for cloud security, cost optimization, and governance, DSL in yaml for policies to query, filter, and take actions on resources
nixopsNixOps is a tool for deploying to NixOS machines in a network or cloud.
aws-missing-toolstools for managing AWS resources including EC2, EBS, RDS, IAM, CloudFormation and Route53.
awspecRSpec tests for your AWS resources.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.