Overview

The AWS CloudFormation templates allow you to deploy a JFrog product in various configurations.  You can deploy a single JFrog Artifactory instance and a High Availability (Enterprise) JFrog Artifactory Cluster (both, with or without JFrog Xray).  

Prerequisites

  • An active AWS subscription
  • Valid JFrog license(s): See deployment chart
  • A domain name with corresponding SSL Certificate (strongly recommended for production)

 

Setting Up Using CloudFormation

Pro/ProX

  1. Select the Pro or ProX deployment option from the table below.
  2.  Change the deployed region name (Optional). 
  3. Complete the form.
    1. Essential Configuration
      • SSH key name: an existing public/private key pair, which allows you to connect securely to your instance after it launches. This is the key pair you created in your preferred region
      • Database Password: AWS RDS PSQL database password for JFrog

      • Availability Zones   

        2 zones must be selected within the VPC.

      • Remote access CIDR:  Range that allows you to connect to the bastion instance by using SSH
    2. Optional Configuration (recommended for production).
      • Artifactory certificate secret name: created in AWS Secrets Manager containing the SSL certificate and certificate key
      • Artifactory server name: matches the domain name stored in the Artifactory certificate secret
      • All other settings are optional or have defaults but can be modified to your requirements
  4. Select Create Stack and follow the instructions.
    The stack will take 10-20 minutes to spin up.
  5. Select stack's Outputs section for the URL to access your instance.
  6. Create a route53 entry for the load balancer to your desired domain name (Optional).

Enterprise/EnterpriseX

  1. Select the Enterprise or EnterpriseX deployment option from the table below.
  2.  Change the deployed region name (Optional).
  3. Complete the form, from the tab  Essential Configuration.
  4. Follow the detailed instructions in AWS Deployment Guide.
Deployment TypeLicense requirementProduct ConfigurationDeployment Option
Pro 

1 Pro (or higher)

  • 1 JFrog Artifactory instance
ProX

1 ProX (or higher) 

  • 1 JFrog Artifactory instance
  • 1 JFrog Xray instance
Enterprise3+ Enterprise (or higher)
  • 3+ JFrog Artifactory instances
EnterpriseX3+ EnterpriseX (or higher)
  • 3+ JFrog Artifactory instances
  • 3+ JFrog Xray instances

Upgrading Using CloudFormation Templates

Pro/ProX - Updating Artifactory

  1. Update your AWS CloudFormation stack using the current template version.
  2. Update the Artifactory master instance version and save the change.
  3. Use the EC2 Auto Scaling Group to rotate the Artifactory instance.

Enterprise/EnterpriseX - Updating Artifactory

  1. Update your AWS CloudFormation stack using the current template version
  2. Update the Artifactory master instance version and save the change
  3. Use the EC2 Auto Scaling Group to rotate the Artifactory master instance
  4. Update the Artifactory member instance version and save the change
  5. Use the EC2 Auto Scaling Group to rotate the Artifactory member instances

ProX/Enterprise/EnterpriseX - Updating Xray

  1. Update your AWS CloudFormation stack using the current template version
  2. Update the Xray instance version and save the change
  3. Use the EC2 Auto Scaling Group to rotate the Xray instance