- クイックインストール
- エージェントコンテナイメージのアップグレード
- カスタムコンテナによるインストール
クイックインストール
エージェントコンテナイメージはDocker Hubで公開されています。エージェントコンテナのインストールは、使用されているスケジューリング、オーケストレーションによって異なります。コンテナは、ホスト固有のメトリックを表示できるように、特権モードで実行する必要があります。
Dockerハブを使用できない、または使用したくない場合は、Instanaから直接コンテナイメージをダウンロードできます。
docker login containers.instana.io -u _ -p <agent_key>
docker pull containers.instana.io/instana/release/agent/dynamic:latest
#downloads the latest version of the dynamic agent
docker pull containers.instana.io/instana/release/agent/static:latest
#downloads the latest version of the static agent
どのコンテナ化環境をお使いでしょうか。
たとえば、ワーカーマシン用の特定のイメージがある場合は、Linux Hostにエージェントを直接インストールすることもできます。現在、いずれの種類のコンテナもホストOSとしてはLinuxのみサポートされていることに注意してください(たとえば、MacのDocker-MachineやWindowsのDockerはサポートされていません)。
エージェントコンテナイメージのアップグレード
場合によっては、エージェントコンテナイメージを手動で更新する必要があります。そのためには、Docker Hubで latestイメージタグのイメージダイジェストを確認し、現在使用されているものと比較してください。現在インストールされているInstana AgentのDockerイメージを確認するには、Kubernetes → 「My Cluster」 → Namespaces → instana-agentに移動し、1つのエージェントポッドを選択し、Instana-agentコンテナを選択して、DockerダッシュボードのイメージSHAを比較します。
Helmを使用している場合は、最新のHelmチャートにアップグレードしてください。
$ helm repo update
$ helm upgrade instana-agent --reuse-values --set agent.image.tag=latest --set agent.image.pullPolicy=Always stable/instana-agent
Kubernetes Yamlを使用している場合は、名前空間を削除してエージェントを再インストールしてください。
$ kubectl apply -f <your-instana-agent-daemonset.yaml>
カスタムコンテナによるインストール
Instanaが提供するエージェントコンテナを使用すると、すぐに使い始めることができますが、通常のエージェントダウンロードに含まれるすべての設定オプションが提供されるわけではありません。
完全にカスタマイズされた独自のエージェントコンテナを構築したいユーザー向けのガイドラインは次の通りです。
- Instana Agentコンテナは、ubuntu:18.04をベースにしています。他のサポートされているOSも同様に動作します
- alpineを実行している場合、glibcサポートを追加します
- コンテナにDockerサポートを追加します
- JDKをコンテナに展開します。 Instana AgentコンテナはAzul Zulu JVMを使用します
- Oracleのalpine(https://hub.docker.com/r/frolvlad/alpine-oraclejdk8/)のようなJava設定済みのLinuxを使用することもできます
- Manual Agent Installationで解説されているエージェントをダウンロードします
- コンテナ内で展開して設定します
- 標準のコンテナログインテグレーションをサポートするには、ファイルログスケジュールを無効にし、コンソールログを有効にする必要があります
- exec /instana-agent/bin/karaf daemon でエージェントを実行します
- exec + the daemon flag でプロセスはリスタートシグナルを正しく処理します
簡単な設定のオーバーライド
FROM instana/agent
COPY my-configuration.yaml /root/configuration.yaml
COPY my-mvn-settings.xml.tmpl /root/mvn-settings.xml.tmpl
COPY com.instana.agent.main.sender.Backend-1.cfg.tmpl /root/com.instana.agent.main.sender.Backend-1.cfg.tmpl
docker build -t myrepro/newagent .
docker push myrepro/newagent:devtag
参考として、Instanaが動的、静的、RHEL Dockerエージェントを設定するために利用するGitHub Dockerプロジェクトを参照してください。