Amazon Elastic Kubernetes Service (Amazon EKS) は、AWS とオンプレミスの両方で Kubernetes を簡単に実行できるマネージド Kubernetes サービスです。 Kubernetesコンテナ化されたアプリケーションのデプロイメント、スケーリング、管理を自動化するためのオープンソース システムです。 このドキュメントでは、AWS Marketplace から EKS アドオンを使用するために必要な手順について説明します。
前提条件
- Amazon Elastic Kubernetes Service (EKS)クラスター。 詳細については、 Kubernetesインテグレーション: 互換性と要件」およびAmazonのユーザーガイドを参照してください。
- 有効な New Relic アカウント。New Relic は、 AWS マーケットプレイスから無料で購読できます。
- New Relic Kubernetes 統合も無料で利用できますので、購読してください。
- New Relicにログインし、ライセンス キーを生成します。
重要
このアドオンは現在、x86 インスタンス タイプでのみサポートされていますが、ARM64 も近日中にサポートされる予定です。
AWS コンソール経由で EKS アドオンをプロビジョニングする
EKS Cluster > Add-Ons > Get More add-onsに移動します。
AWS Marketplace アドオンで、 New Relic Kubernetesインテグレーションを検索、参照、または移動し、チェックボックスを選択して、Next をクリックします。
必要に応じて、最新のデフォルト バージョンを選択するか、代替バージョンを選択して、 Nextをクリックします。
Createをクリックします。
数分以内に、New Relic の Kubernetes オペレーターがアクティブ化され、実行が開始されます。EKS クラスターから可観測性データを収集して New Relic に送信するには、以下の構成手順を参照してください。
AWS CLI 経由で EKS アドオンをプロビジョニングする
EKS クラスターの名前として--cluster-name
を使用して、次のコマンドを実行して NewRelic アドオンをインストールします。
$aws eks create-addon --cluster-name REPLACE_ME --addon-name new-relic_kubernetes-operator
次のような出力が表示されます。
${$ "addon": {$ "addonName": "new-relic_kubernetes-operator",$ "clusterName": "newrelic-test",$ "status": "CREATING",$ "addonVersion": "v0.1.8-eksbuild.1",$ "health": {$ "issues": []$ },$ "addonArn": "arn:aws:eks:ap-northeast-2:###############:addon/kubecon2023-127/new-relic_kubernetes-operator/6cc5e7b7-d8f1-5fa0-c668-2bc9727e16b3",$ "createdAt": "2023-07-27T11:47:57.023000-07:00",$ "modifiedAt": "2023-07-27T11:47:57.044000-07:00",$ "tags": {}$ }$ }
Kubernetes オペレーターを構成する
CLI でkubectl get all -n newrelic
を実行すると、Kubernetes オペレーターが動作していることを確認できます。メトリクスの収集を開始して New Relic に出荷するには、次のサンプル カスタム リソース定義 (CRD) を使用します。
以下の定義を使用して、
spec.global.cluster
EKS クラスターの名前、spec.global.licensekey
New Relic ライセンス キーとして使用して、crd.yml
ファイルを作成します。apiVersion: newrelic.com/v1alpha1kind: NRIBundlemetadata:name: nribundle-samplespec:global:cluster: "<cluster>"licenseKey: "<licenseKey>"lowDataMode: truenewrelic-infrastructure:enabled: trueprivileged: truekube-state-metrics:image:tag: "v2.10.0"enabled: truekubeEvents:enabled: truenewrelic-prometheus-agent:enabled: truelowDataMode: trueconfig:kubernetes:integrations_filter:enabled: false必要な構成を更新したら、次のコマンドを使用してソリューションをアップグレードします。
kubectl apply -f crd.yml -n newrelic