デプロイ
Dockerを使用してデプロイを開始するためのオプションは、次の2つです。
- 独自のイメージを作成し、最初からエージェントを開始する。
- 既存のイメージを実行する(.NET エージェントを有効にしている場合)。
独自のイメージを作成する
MicrosoftおよびDockerfileから提供されたASP.NETアプリケーションのサンプルを使用して、独自のイメージを作成し、開始します。
- バイナリをダウンロードします。
- Dockerfileの変数を更新して、AppDynamicsでコントローラおよびアプリケーションIDへの接続を構成します。
- Dockerイメージを作成します。
次に、Dockerfile の例をコメント付きの手順とともに示します。
FROM mcr.microsoft.com/dotnet/core/samples:aspnetapp
####### Requirements
# Have the following files alongside the Dockerfile:
# * libappdprofiler_arm64.so
# * AppDynamics.Agent.netstandard.dll
####### Instructions
# Building image: docker build --rm -t appdynamicstest:latest .
# Running container: docker run --rm -p 8000:80 appdynamicstest:latest
# Open the application using http://localhost:8000/
# Copy agent binaries to the image from current folder
RUN mkdir -p /opt/appdynamics/dotnet
ADD libappdprofiler_arm64.so /opt/appdynamics/dotnet/
ADD libappdprofiler_glibc_arm64.so /opt/appdynamics/dotnet/
ADD libappdprofiler_musl_arm64.so /opt/appdynamics/dotnet/
ADD AppDynamics.Agent.netstandard.dll /opt/appdynamics/dotnet/
# Mandatory settings required to attach the agent to the .NET application
ENV CORECLR_PROFILER={57e1aa68-2229-41aa-9931-a6e93bbc64d8} \
CORECLR_ENABLE_PROFILING=1 \
CORECLR_PROFILER_PATH_ARM64=/opt/appdynamics/dotnet/libappdprofiler.so
# Configure connection to the controller
ENV APPDYNAMICS_CONTROLLER_HOST_NAME=controller.saas.appdynamics.com
ENV APPDYNAMICS_CONTROLLER_PORT=443
ENV APPDYNAMICS_CONTROLLER_SSL_ENABLED=true
ENV APPDYNAMICS_AGENT_ACCOUNT_NAME=account-name
ENV APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY=access-key
# Configure application identity in AppDynamics
ENV APPDYNAMICS_AGENT_APPLICATION_NAME="My Application"
ENV APPDYNAMICS_AGENT_TIER_NAME="Sample Tier"
ENV APPDYNAMICS_AGENT_REUSE_NODE_NAME=true
ENV APPDYNAMICS_AGENT_REUSE_NODE_NAME_PREFIX="Instance"
# It is possible to configure .NET agent using AppDynamicsConfig.json configuration file instead of environment variables
# ADD AppDynamicsConfig.json /opt/appdynamics/dotnet/Alpine でアプリケーションを実行するには、ENV LD_LIBRARY_PATH=/opt/appdynamics/ dotnet などの追加の環境変数 LD_LIBRARY_PATH が必須です。
既存のイメージを実行する
エージェントが有効になっている状態で既存のイメージを実行できます。これは、新しいイメージを作成する必要がないため、最も簡単な開始方法です。
- aforementioned binaries をダウンロードします。
Dockerコマンドの変数を更新して、AppDynamicsでコントローラおよびアプリケーションIDへの接続を構成します。
zip ファイルからエージェントバイナリを抽出した目的のフォルダでコマンドを実行します。コマンドの
$(pwd)は、このフォルダで置き換えることができます。
次の例では、アプリケーションのサンプルを実行します。現在のディレクトリに Splunk AppDynamics バイナリがあることが前提となっています。
docker run \
-p 8000:80 \
-e CORECLR_PROFILER={57e1aa68-2229-41aa-9931-a6e93bbc64d8} \
-e CORECLR_ENABLE_PROFILING=1 \
-e CORECLR_PROFILER_PATH_ARM64=/opt/appdynamics/dotnet/libappdprofiler.so \
-e APPDYNAMICS_CONTROLLER_HOST_NAME=controller.saas.appdynamics.com \
-e APPDYNAMICS_CONTROLLER_PORT=443 \
-e APPDYNAMICS_CONTROLLER_SSL_ENABLED=true \
-e APPDYNAMICS_AGENT_ACCOUNT_NAME=account-name \
-e APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY=access-key \
-e APPDYNAMICS_AGENT_APPLICATION_NAME="My Application" \
-e APPDYNAMICS_AGENT_TIER_NAME="Sample Tier" \
-e APPDYNAMICS_AGENT_REUSE_NODE_NAME=true \
-e APPDYNAMICS_AGENT_REUSE_NODE_NAME_PREFIX="Instance" \
-v "$(pwd)":/opt/appdynamics/dotnet/ \
mcr.microsoft.com/dotnet/core/samples:aspnetappAlpine でアプリケーションを実行するには、-e LD_LIBRARY_PATH=/opt/appdynamics/ dotnet \ などの追加の環境変数 LD_LIBRARY_PATH が必須です。
このコマンドでは、エージェントファイルがボリュームとしてマウントされ、エージェントでの追加に必要な環境変数が設定されます。