Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Announcement: Try the Ask AI chatbot for answers to your technical questions about Juniper products and solutions.

close
header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Juniper Apstra 5.1.0 User Guide
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

Launch Juniper Apstra Cloud Services Edge Docker Containers in Apstra

date_range 21-Mar-25

Use the following steps to manage and launch Juniper Apstra Edge Docker containers natively within the Apstra GUI.

In Juniper Apstra release 5.1 or later, you can install the Apstra Edge from within Juniper Apstra. The Edge is a hardware-agnostic virtual device that runs within a container in the data center. It is a required component for enabling ACS and it's supported features, like Service Awareness, Impact Analysis, and Service Level Expectations.

To install the Edge from within Juniper Apstra:

Note:

In Juniper Apstra 5.1 and later, each Apstra image is bundled together with an Apstra Edge image. When you download the 5.1 (or later) image from the Support site, it comes with Apstra Edge version 0.13.2.

For Juniper Apstra version 5.0 and earlier, you must use the steps in the following guide to install the Edge: Juniper Apstra Cloud Services Edge Setup Guide.

  1. From within the ACS GUI, navigate to Organization > Inventory.
  2. Click Adopt Apstra Edge at the top right side of the page.
    The Adopt Apstra Edge window displays.


  3. In a separate browser window, log in to your Juniper Apstra GUI.
  4. Copy the management URL of your Juniper Apstra GUI (the URL of the Apstra GUI)
  5. From within the Adopt Apstra Edge window of the ACS GUI, fill in the following:
    • Edge Name: The name of the Juniper Apstra Edge instance

    • Management URL: The management URL of Juniper Apstra

    • Username: The username you use to access Juniper Apstra

    • Password: The password you use to access Juniper Apstra

    • Apstra Edge Download Location: The Juniper Downloads URL for the latest Apstra Edge distribution. Use the following Juniper Downloads link to download the latest Apstra Edge version: https://support.juniper.net/support/downloads/?p=apstra.

  6. Click Adopt.
    The new Apstra Edge appears in the Inventory list.
  7. Click the box next to the new Apstra Edge, and click the More dropdown menu > Get Registration Code.
  8. Copy the registration code and click Close.
  9. From the Juniper Apstra GUI, navigate to Platform > Apstra Edge.
  10. Click the plus icon at the top right of the page to launch a new Apstra Edge container.
    The Create Apstra Edge window displays.


  11. Enter the following information:
    • Registration key: Paste the Apstra Edge registration code here. This code links your local Apstra controller to ACS.

    • Cloud term: The endpoint URL the Edge uses to communicate with the cloud (the current default URL is ep‑term.ai.juniper.net).

    Optional fields (These fields are populated with default values if left blank):

    • Image name: The name of the Apstra Edge container image downloaded from the Juniper support site. This container will be deployed on your local Apstra VM.

    • Container CPU limit: The maximum number of CPU cores allocated to the Edge container. This limits the container's processing resources. The default value is 0.5.

    • Container CPU shares limit: The relative CPU share allocation for the Edge container. This controls how CPU resources are distributed when multiple containers compete for processing power. The default value is 1024.

    • Container memory limit: The maximum amount of RAM the Edge container can use. This prevents the container from consuming excessive memory resources. The default value is 500m.

    • Environment variables: Configure additional Docker container environment variables. These parameters allow for custom container configuration settings. For a complete list of available variables, refer to the Apstra Edge Internal Variables documentation. (https://www.juniper.net/documentation/us/en/software/apstra5.0/apstra-cloud-services-edge-guide/apstra-cloud-services/topics/concept/apstra-edge-internal-variables.html).

  12. Click Create.
    The new Edge configuration displays. The State should change from Queued to LAUNCHED. This might take up to a minute.


  13. From the ACS GUI, verify that the Cloud and Apstra Connectivity statuses are Connected.


    To edit config details of your Edge from within the Apstra GUI, navigate to Platform > Apstra Edge.
footer-navigation