Skip to content

Latest commit

 

History

History
43 lines (37 loc) · 1.94 KB

README.md

File metadata and controls

43 lines (37 loc) · 1.94 KB

apstra-ami-builder

This repository faciliates running Juniper Apstra in AWS.

Prerequisites

  1. An AWS account.
  2. Credentials for the AWS account in your environment/config, with sufficient permissions to create the required AWS resources.
  3. Software on your deployment system:
    • Git (to clone this repo)
    • Terraform (to deploy the AWS resources)
    • AWS CLI (to kick off the process after deployment)
    • jq (used in the deployment process script to process json)

Usage

Step 1 - deploy AWS resources
  1. Clone this repository to your local system. 
    git clone https://github.com/chrismarget-j/apstra-ami-builder
cd apstra-ami-builder
  2. Deploy resources to AWS. Broadly speaking, those are:
    • AWS ImageBuilder components, recipe, pipeline, etc... capable of building an AMI appropriate for processing a new Apstra release into an AWS AMI.
    • AWS IAM policies, etc... required to run ImageBuilder.
    • AWS IAM policies, etc... required by the Imagebuilder output to process an Apstra release.
    • AWS S3 bucket and object which house a script containing the Apstra Release -> AWS AMI conversion process.
    terraform -chdir=terraform init
terraform -chdir=terraform apply
  3. Run the ImageBuilder Pipeline. This step could be performed by Terraform, but it takes a while. I prefer running it via the web UI. From the AWS ImageBuilder console select the apstra-ami-builder pipeline and then Actions->Run Pipeline. Running the pipeline will create a new AMI in the account. Eventually.
  4. Run the deploy script from the top level directory of this repository. It will prompt for an Apstra download URL, and then launch the apstra-ami-builder AMI as an EC2 instance. That instance will fetch the Apstra release from the supplied URL, process it into a cloud-init-enabled AMI in the account, and then shut itself down. 
    ./deploy_from_juniper_cdn.sh