Install CSV provider

To install the CSV File provider, create a YAML file (called provider.yml in this example) with the specification of the provider:

# CSV File Telemetry Provider
name: CSV File
description: Telemetry Provider that enables to import of metrics from a remote CSV file
dockerImage: 485790562880.dkr.ecr.us-east-2.amazonaws.com/akamas/telemetry-providers/csv-file-provider:3.2.0

Then, you can then install the provider with the Akamas CLI:

akamas install telemetry-provider provider.yml

Offline Installation

An offline installation is designed for air-gapped or isolated environments where the Kubernetes cluster cannot directly access public repositories to download Docker images. In such scenarios, all necessary images—including telemetry providers—must be pre-downloaded, re-tagged, and pushed to a private registry that the cluster can access.

Note: The following steps must be executed from a terminal that has internet access and connectivity to your private registry. This is required to pull the image from the public repository and then push it to your private registry. Once the images are available in your private registry, your offline environment can use them.

CSV File Telemetry Provider Offline Procedure

To install the CSV File Telemetry Provider in an offline environment, follow these steps:

1. Download and Transfer the Image to Your Private Registry:

   Use Docker to pull the image from the public repository, re-tag it, and push it to your private registry. For example, if your private registry is myprivateregistry.com, execute:

   # Pull the image from the public repository
   docker pull 485790562880.dkr.ecr.us-east-2.amazonaws.com/akamas/telemetry-providers/csv-file-provider:3.2.0
   
   # Re-tag the image for your private registry
   docker tag 485790562880.dkr.ecr.us-east-2.amazonaws.com/akamas/telemetry-providers/csv-file-provider:3.2.0 myprivateregistry.com/akamas/telemetry-providers/csv-file-provider:3.2.0
   
   # Push the image to your private registry
   docker push myprivateregistry.com/akamas/telemetry-providers/csv-file-provider:3.2.0

2. Create the Updated YAML File:

   Create a YAML file (e.g., provider.yml) with the provider specification, updating the dockerImage reference to point to your private registry:

   # CSV File Telemetry Provider
   name: CSV File
   description: Telemetry Provider that enables the import of metrics from a remote CSV file
   dockerImage: myprivateregistry.com/akamas/telemetry-providers/csv-file-provider:3.2.0

3. Install the Provider Using the Akamas CLI:

   With the updated YAML file, run the following command to install the provider:

   akamas install telemetry-provider provider.yml

   This command instructs the Akamas CLI to retrieve the image from your private registry, ensuring that the installation succeeds even in an offline environment.