Saltar al contenido principal
Versión: 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