1.4.X

Introduction

This section walks through building, installing, and upgrading a production Orchestrator deployment.

This includes building required artifacts (container images, Helm charts), deploying to Amazon Elastic Kubernetes Service (EKS), and upgrading between Orchestrator release versions.

Prerequisites

Throughout this guide we assume the MAGMA_ROOT environment variable is set to the local directory where you cloned the Magma repository

export MAGMA_ROOT=PATH_TO_YOUR_MAGMA_CLONE

Before deployment, it may be useful to read through the Magma prerequisites and Magma quick start guide sections.

Familiarity with the following is assumed

  • AWS
  • Kubernetes
  • Terraform

The instructions in this section have been tested on macOS and Linux. If you are deploying from a Windows host, some shell commands will likely require adjustments.

Deploying specific release

To target a specific release, checkout the Magma repository's relevant release branch when building artifacts. This is also a great place to find relevant Terraform values.

Values for recent Orchestrator releases are summarized below

v1.4.0

Verified with Terraform version 0.14.0. The latest Terraform version will likely work as well.

  • v1.4 patch branch
  • github.com/magma/magma//orc8r/cloud/deploy/terraform/orc8r-aws?ref=v1.4 Terraform module source
  • 1.5.8 Helm chart version
  • Additional notes
    • 9.6 PostgreSQL target release, newer versions will likely work as well

v1.3.0

Verified with Terraform version 0.13.1. The latest Terraform version will likely work as well.

  • v1.3 patch branch
  • github.com/magma/magma//orc8r/cloud/deploy/terraform/orc8r-aws?ref=v1.3 Terraform module source
  • 1.4.36 Helm chart version
  • Additional notes
    • 9.6 PostgreSQL target release, newer versions will likely work as well

v1.2.0

Verified with Terraform version 0.13.1. The latest Terraform version will likely work as well.

  • v1.2 patch branch
  • github.com/magma/magma//orc8r/cloud/deploy/terraform/orc8r-aws?ref=v1.2 Terraform module source
  • 1.4.35 Helm chart version
  • Additional notes
    • 9.6 PostgreSQL target release, newer versions will likely work as well

v1.1.0

Verified with Terraform version 0.12.29. The latest Terraform version will likely work as well.

  • v1.1 patch branch
  • github.com/magma/magma//orc8r/cloud/deploy/terraform/orc8r-aws?ref=v1.1 Terraform module source
  • 1.4.21 Helm chart version
  • Additional notes
    • 9.6 PostgreSQL target release, newer versions will likely work as well

Deployment Types

Orc8r deployment type specifies the Orc8r modules which will be included to manage Magma gateways. It supports following deployment types.

  • fwa for fixed wireless deployment, enables management of AGWs
  • federated_fwa for federated fixed wireless deployment, enables management of AGWs and FEGs
  • all for all-encompasing deployments, enables management of AGWs, FEGs, and CWAGs
← SecurityNext →