You are here

Burris Builder AWS Integration

Overview

Burris Builder tools are designed to simplify AWS. This section describes AWS intergration with Burris Builder. Every tab here interacts with AWS via the PHP-SDK and creates or manipulates real computing resources which may result in additional billing. Please be mindful of your creations.

Burris Builder configuration may be reached by selecting "Menu" from the top navibation bar, then clicking Burris Builder. From this screen select Burris AWS. You may also find documentation on Burris Builder Configuration and Burris Builder Status.

In order to reach this panel, you must have Burris AWS activated and have an IAM User setup with the proper premissions. See Burris Builder Setup for details.

Storage Panel

This panel describe all EBS volumes which are relevant to your server. From here, you may create volumes and capture, attach or detach snapshots for your server.

Create New Volume

This option allows you to allocate more store via an additional EBS volume. Once you have added a new volume to the Burris Builder server, you may select this volume when installing new websites. The option to select an EBS volume is covered in more detail in Building a Website section.

There are four stages to creating a new volume for the server: provisioning, attaching, formatting and Nginx/Apache configuring. Burris Builder handles every stage for you, including additional features such as name and description tagging, encryption key creation and of course making sure your EBS volume is in the same zone as your current server.

If you prefer to handle certain stages manually, for instance you may want to choose your own manual formatting (Burris Builder uses ext 4), you may deselect any of the volume options.

Volume Name and Description: These are added to the volume as tags when it is created. The name may be seen in the AWS console for reference, and the description will carry over when a snapshot is taken or restored.

Volume Type: These options reflect the hard drive options available for AWS. Generally, SSD is recommended and traditional magnetic is only recommended for infrequent access.

Volume Size SSD volume types has direct baseline IOPS performance according to their size, although all SSD allocations have "burst" performance.

Attach drive to this server is essentially, plugging it in to the server. It does not mount the drive for use, it simply makes it available under the "/dev" location, where it may then be formatted, mounted and configured. This is required if the "Formate and mount" option is selected.

Format and mount the drive Will format with ext4, mount it under a "www" folder so websites may be installed on it, and configure Nginx and Apache files so configuration files on this drive will be loaded into their respective services.

Create Volume When finished, click "Create Volume". A new EBS volume will be allocated according to the options selected.

Burris Builder also adds its own tags when a drive is created so it knows if it has been used for installing websites before, and its previous mountpoint location in order to make restoring old volumes a simpler process.

Attached Volumes

This is a list of volumes currently attached to the server. There is always a "root" volume, noted by the "root" mount point. This drive cannot be detached from the server, but you may take a snapshot. A snapshot of the root drive is useful for preserving data specific to that server. If you're going to register this snapshot as an AMI, however, it is recommended the server be shut down first and the snapshot be taken from the AWS console.

Remining devices for application data have options available according to their current status. If a drive is attached, but not mounted a mount option will be availabe. If it is mounted and attached, a Detach and Import Websites option will be available.

Attaching and Detaching Drives

Before a drive is ready for website installation, it must be formatted and configured for Nginx and Apache. In order to detach a drive, Nginx and Apache must be reconfigured again so they do not look for configuration files which do not exist.

Available Volumes

Any drives which are left unattached are listed in available drives. Your drives will also be visible in this section after they have been restored.

Snapshot Panel

All of the snapshots you have taken, either through the AWS console or through Burris Builder, will be listed here. There is only one action to take here: Restore. Clicking "Restore" will provide options for transforming a snapshot back into a usable, attached volume.

Please note that you cannot restore a drive to a smaller size than what was originally captured. If you designate a size smaller than the original snapshot size, your drive will be restored to its original snapshot size. Designating a size larger than your orignal snapshot size will correctly designate that size.

Note the orange button which indicates costs associated with proceeding, Restore button here upon completion. You will be charged according to AWS EBS volume prices.

Once you have restored a volume it will be available in the "Available Drives" section

Database Panel

The database panel lists RDS servers which are available to your server. These are the same datbases listed if you configure databases for building websites. You may also create a new RDS from this panel. The create RDS form is covered in Burris Builder setup.

Domains Panel

The domain panel shows you all of the zones available in Route 53. The advantage to using this console is quick visibility into which domains are active for your server. After clicking on a domain, you provided a list of records for that zone. Zones pointing to an IP matching the IP address of your current server will be highlighted in green.

Adding functionality to this panel is in active development

CDN Panel

The CloudFront distributions you have deployed will be visible here. This panel is for reference only. If you would like to create a CDN, visit a website you have created, be selecting it from the home list.