How to Deploy APMInsight .NET Agent Docker Image in Air-Gapped (Offline) Environments
This guide explains how to use the APMInsight .NET Agent Docker image in environments without direct internet access by transferring it through a private container registry.
Overview
Since air-gapped (isolated from internet) environments cannot pull images directly from public registries, you need to:
1. Use an internet-enabled machine to pull the image from the public Docker Hub
2. Export the image as a .tar file
3. Transfer the file to your environment
4. Push it to your private container registry
Prerequisites
- A machine with internet access to pull images from Docker Hub
- Docker installed on both the internet-enabled machine and target environment
- Access to a private container registry accessible from your air-gapped environment
Steps
Step 1: Pull and Save the Image (On a machine WITH internet access)
On a machine that has internet connectivity, pull the image from the public repository and save it as a `.tar` file:
- docker pull site24x7/apminsight-dotnetagent:latest
- docker save -o apminsight-dotnetagent.tar site24x7/apminsight-dotnetagent:latest
This creates a .tar file in your current directory.
Step 2: Transfer the Tar File
Transfer the .tar file from the internet-enabled machine to a machine that has access to your private registry. Use SCP, SFTP, USB drive, or any approved file transfer method.
Step 3: Load the Image
On the machine with access to your private registry, load the image:
- docker load -i /path/to/apminsight-dotnetagent.tar
Step 4: Tag the Image for Your Private Repository
- docker tag site24x7/apminsight-dotnetagent:latest <private-repo-url>/<image-name>:<tag>
Step 5: Push to Your Private Repository
- docker login <private-repo-url>
- docker push <private-repo-url>/<image-name>:<tag>
Example
Steps to be followed once image's tar file is created from machine with internet access
# Step 1: Load the image
docker load -i apminsight-dotnetagent.tar
# Step 2: Verify the image is loaded
docker images | grep apminsight-dotnetagent
# Step 3: Tag for your private registry
docker tag site24x7/apminsight-dotnetagent:latest myregistry.example.com/apminsight-dotnetagent:latest
# Step 4: Login to your private registry
docker login myregistry.example.com
# Step 5: Push to private repository
docker push myregistry.example.com/apminsight-dotnetagent:latest
Note: To use a specific version instead of latest, replace the tag in all commands.
For example, use site24x7/apminsight-dotnetagent:7.0.2 instead of site24x7/apminsight-dotnetagent:latest
Note: To use a specific version instead of latest, replace the tag in all commands.
For example, use site24x7/apminsight-dotnetagent:7.0.2 instead of site24x7/apminsight-dotnetagent:latest
Next Steps: Agent Onboarding
For onboarding the .NET agent in a Linux OpenShift/Kubernetes environment, refer to Adding APMInsight .NET Agent in Kubernetes via InitContainers
Important: Replace the public image reference (site24x7/apminsight-dotnetagent:latest) in the onboarding documentation with your private repository image URL.
New to ADSelfService Plus?
Related Articles
Adding APM Insight Java agent in a Kubernetes environment
There are three methods for installing the APM Insight Java agent in a Kubernetes environment: Using Dockerfile Using InitContainers Using Persistent Volumes Prerequisites Download the latest APM Insight Java agent ZIP file. Extract the ZIP file and ...How to add an APM Insight Node.js agent in Kubernetes via InitContainers?
To integrate the APM Insight Node.js agent into your Kubernetes applications using InitContainers, follow the steps given below: Step 1: Create an empty volume that will be used to copy the agent files during the initContainers process. Example: ...How to add an APM Insight Python agent in Kubernetes via InitContainers?
Adding the APM Insight Python agent via init containers in Kubernetes enables the seamless integration of performance monitoring for Python applications, ensuring efficient tracking and analysis of application behavior within the Kubernetes ...How to Install .NET agent on AWS Elastic Beanstalk?
One of the two options listed below can be used to install APM Insight agent onto a .NET web application hosted in Elastic Beanstalk environment via ebextensions. Deployment through AWS kit for Visual Studio. Deployment via uploading packages to AWS ...How to add an APM Insight Java agent in Kubernetes via InitContainers?
Step 1. Create a secret to access the APM Insight license key in your application namespace: kubectl create secret generic app-secret --from-literal=s247licensekey='your_APMInsight_license_key' -n petclinic The license key can be obtained from the ...