Skip to main content
Version: 2.32.2

Docker

Below are the instructions to install the Aperture Agent on Docker.

Prerequisites

  1. Install Docker on your system.

Installation

  1. Create a file named agent.yaml with the below content for passing the configuration to the Aperture Agent:

    fluxninja:
    enable_cloud_controller: true
    endpoint: "ORGANIZATION_NAME.app.fluxninja.com:443"
    api_key: "API_KEY"
    log:
    level: info
    pretty_console: true
    non_blocking: false
    otel:
    disable_kubernetes_scraper: true
    disable_kubelet_scraper: true
    auto_scale:
    kubernetes:
    enabled: false
    service_discovery:
    kubernetes:
    enabled: false

    Replace ORGANIZATION_NAME with the Aperture Cloud organization name and API_KEY with the API key linked to the project. Navigate to the Aperture tab in the sidebar menu and then select API Keys in the top bar. From there, you can either copy the existing key or create a new one by clicking on Create API Key. For detailed instructions on locating API Keys, refer to the API Keys section.

    note

    If you are using a Self-Hosted Controller Aperture Controller, modify the above configuration as explained in Self-hosted Agent Configuration.

    All the configuration parameters for the Aperture Agent are available here.

  2. Run the below command to start the Aperture Agent container:

    docker run -d \
    -p 8081:8080 \
    --name aperture-agent \
    --network aperture \
    -v "$(pwd)"/agent.yaml:/etc/aperture/aperture-agent/config/aperture-agent.yaml:ro \
    docker.io/fluxninja/aperture-agent:2.32.2
  3. Verify that the Aperture Agent container is in the healthy state:

    docker run -it --rm \
    --network aperture curlimages/curl \
    sh -c \
    'while [[ \"$(curl -s -o /dev/null -w %{http_code} aperture-agent:8080/v1/status/system/readiness)\" != \"200\" ]]; \
    do echo "aperture-agent is starting"; sleep 1; done && \
    echo "aperture-agent is now healty!"'

Uninstall

  1. Run the below command to stop and remove the Aperture Agent container:

    docker rm -f aperture-agent