虛構 PoP 部署

安裝虛構 PoP

使用 helm install 指令來安裝新的虛構 PoP，並傳遞下列值。 建議您在個別名稱空間中安裝 PoP 。

• downloadKey: 用於從 containers.instana.io Docker 登錄取回映像檔的下載代理程式金鑰。
• controller.location: 格式為 label; displayLabel; country; city; latitude; longitude; description。 此標籤充當 PoP ID ，且只能包含字母、數字、連字號及底線。
• controller.instanaKey:Instana 代理程式金鑰，用於連接至 Instana 後端。
• controller.instanaSyntheticEndpoint: Instana 後端中 Synthetic 接收器的入口端點。
• controller.clusterName: 選擇性地。 當安裝 Instana 代理程式以監視此 PoP時，需要使用要顯示在 Instana 使用者介面中的 Kubernetes 叢集名稱來設定它。
• redis.password:redis 伺服器的鑑別密碼。 請指定長度至少為 10 的密碼。
• redis.tls.enabled: 定義是否啟用 Redis TLS (預設值為 false)。 如果值為 true，則會使用 TLS 來加密與 Redis 的通訊。
• redis.tls.secretName: 如果 redis.tls.enabled 欄位的值為 true，則需要為 Redis TLS key/cert 檔案指定密鑰名稱。

登入 Instana 使用者介面，按一下 虛構監視，然後按一下 部署 PoP。 複製 downloadKey、 controller.instanaKey 和 controller.instanaSyntheticEndpoint的值。

若要配置安裝，請使用 --set 旗標在指令行中指定值，或使用 -f 旗標向 yaml 檔案提供您的值。

在下列範例中，部署 PoP ，且 Redis 使用密碼進行鑑別。

helm install synthetic-pop \
    --repo https://agents.instana.io/helm  \
    --namespace syn \
    --create-namespace \
    --set downloadKey="yourdownloadkey" \
    --set controller.location="MyPoP;My PoP;China;Beijing;39.54;116.23;This is a testing Synthetic Point of Presence" \
    --set controller.instanaKey="instanaAgentkey" \
    --set controller.instanaSyntheticEndpoint="https://synthetics-green-saas.instana.io" \
    --set redis.tls.enabled=false \
    --set redis.password="a1fc5d01bcbb" \
    synthetic-pop

您也可以提供 values.yaml 以部署 PoP，下面的範例顯示如何取得 values.yaml 範本，然後傳遞已修改的 yaml 檔案以部署 PoP。

helm repo add synthetic-pop-repo https://agents.instana.io/helm
helm repo update
helm pull synthetic-pop-repo/synthetic-pop
tar xzvf synthetic-pop-*.tgz
# Modify the synthetic-pop/values.yaml file
# Run helm install to pass the modified values.yaml
 helm install synthetic-pop \
    --repo https://agents.instana.io/helm  \
    --namespace syn \
    --create-namespace \
    -f /path/to/values.yaml \
    synthetic-pop

安裝 PoP 之後，請確定每一個 Pod 都處於 Running 及 Ready 狀態。

kubectl get pod -n syn

登入 Instana 使用者介面，按一下 Synthetic _Monitoring > 位置，然後您可以看到您的位置顯示在位置清單中。 如果沒有，請移至 疑難排解 區段，以檢查日誌檔。

安全加強功能

對於正式作業環境中的安全加強功能，建議使用下列配置。

openssl genrsa -out tls.key 4096
openssl req -x509 -new -nodes -sha256 -key tls.key -days 3650 -subj '/O=Instana/CN=Certificate Authority' -out ca.crt
openssl req -new -sha256 -key tls.key -subj '/O=Instana/CN=Server' | openssl x509 -req -sha256 -CA ca.crt -CAkey tls.key -CAserial ca.txt -CAcreateserial -days 3650 -out tls.crt

# Create a new TLS secret named pop-tls-secret with the given key/cert files
kubectl create secret generic pop-tls-secret -n syn \
--type='kubernetes.io/tls' \
--from-file=ca.crt=path/to/ca.crt \
--from-file=tls.crt=path/to/tls.crt \
--from-file=tls.key=path/to/tls.key

helm install synthetic-pop \
    --repo https://agents.instana.io/helm \
    --namespace syn \
    --create-namespace \
    --set downloadKey="yourdownloadkey" \
    --set controller.location="MyPoP;My PoP;China;Beijing;39.54;116.23;This is a testing Synthetic Point of Presence" \
    --set controller.instanaKey="instanaAgentkey" \
    --set controller.instanaSyntheticEndpoint="https://synthetics-green-saas.instana.io" \
    --set redis.tls.enabled=true \
    --set redis.tls.secretName="pop-tls-secret" \
    synthetic-pop

helm install synthetic-pop \
    --repo https://agents.instana.io/helm \
    --namespace syn \
   ...
    --set seccompDefault=true \
    synthetic-pop

# Use the following command to print apiserver endpoint
# For example, if the following command prints "Endpoints: 10.128.0.127:16443", you need to block the IP address 10.128.0.127 
kubectl describe service kubernetes

playbackEngineNetworkPolicy:
  # Change the value to true to enable the network policy
  enabled: true
  egress:
    - to:
        - ipBlock:
            # Allow all IP address v4
            cidr: 0.0.0.0/0
            except:
              # Block Kubernetes API server IP address
              - 10.128.0.127/32
              # Block cloud provider metadata service IP address
              - 169.254.169.254/32

# --set-json only be supported since Helm V3.11
helm install synthetic-pop \
    --repo https://agents.instana.io/helm \
    --namespace syn \
   ...
    --set playbackEngineNetworkPolicy.enabled=true \
    --set-json 'playbackEngineNetworkPolicy.egress=[{"to":[{"ipBlock":{"cidr":"0.0.0.0/0","except":["10.128.0.127/32","169.254.169.254/32"]}}]}]' \
    synthetic-pop

移轉實務範例

若要支援後端移轉實務範例，您可以使用分號指定多個 Synthetic Acceptor 端點及 Instana 代理程式金鑰。 Instana 代理程式金鑰及 Synthetic Acceptor 端點是一對一對應。 在移轉期間，虛構 PoP 可以將資料傳送至舊後端及新後端，以避免關閉時間。

請參閱下列範例：

helm install synthetic-pop \
    --repo https://agents.instana.io/helm \
    --namespace syn \
    --set controller.instanaKey="instanaAgentkey;anotherInstanaAgentKey" \
    --set controller.instanaSyntheticEndpoint="https://synthetics-green-saas.instana.io;https://synthetics-green-saas.instana.host" \
    ...

播放引擎啟用

依預設，會啟用並部署三個播放引擎。 您可以根據需求來停用其中部分。
例如，如果您不需要「瀏覽器」測試，則可以透過傳遞下列參數來停用 BrowserScript 播放引擎，以減少 Synthetic PoP所需的 CPU 及記憶體資源。

--set browserscript.enabled=false

可調整性

目前，只有播放引擎支援水平可調整性，而 PoP Controller 和 Redis 尚不支援水平可調整性。 PoP 工作負載主要是在播放引擎 Pod 上。 因此，如果要在特定類型的測試上支援更多工作量，只要在 values.yaml 檔中增加 replicas 數目即可。

下列範例顯示 JavaScript 播放引擎的抄本數增加到 2 ，而 BrowserScript 播放引擎的抄本數增加到 3。

--set javascript.replicas=2
--set browserscript.replicas=3

功能

controller.capabilities 內容定義 Synthetic PoP的播放功能，包括支援的 Synthetic 測試和 Web 瀏覽器類型。

CustomProperties

controller.customProperties 內容定義此 PoP的自訂標籤或內容。 內容是 key:value 配對的清單，以分號區隔，例如 key1=value1;key2=value2。

使用 API (例如 $env.key1 ) 來存取 API 或瀏覽器 Script 中的自訂內容或標籤。

Proxy

您可以配置虛構 PoP 的 Proxy 伺服器，以連接 Instana 後端伺服器。 支援下列選項。

• proxy.popProxyProtocol:Proxy 伺服器所使用的通訊協定。 將值設為 http 或 socks。
• proxy.popProxyServer: ipaddress:port 格式的 Proxy 伺服器位址。
• proxy.popProxyUserPass: 用來鑑別 Proxy 伺服器的使用者名稱和密碼。 以 username:password 格式輸入使用者名稱和密碼。

附註: 若要配置虛構 PoP 的 Proxy 伺服器以連接至受監視的服務，您可以使用 $network API 在 API Script 中設定 Proxy 伺服器。

使用外部密碼

如果您不想使用 Helm 圖表來建立金鑰 controller.instanaKey、 redis.password、 proxy.popProxyUserPass及 downloadKey的新密鑰，則可以透過指定密鑰名稱來使用您為 Synthetic PoP 部署建立的現有密鑰，如下所示:

helm install synthetic-pop \
    --repo https://agents.instana.io/helm \
    --namespace syn \
    --set downloadSecret="my-pull-secret" \
    --set controller.instanaKeySecret="my-pop-secret" \
    --set redis.passwordSecret="my-pop-secret" \ 
    --set proxy.popProxyUserPassSecret="my-pop-secret" \
    ...

對於金鑰 controller.instanaKey、 redis.password和 proxy.popProxyUserPass，您可以使用相同的密鑰或不同的現有密鑰。 不過，當您建立密鑰時，必須使用指定的索引鍵欄位 instana-key、 redis-password及 proxy-user-pass ，如下所示:

 kubectl create secret generic my-pop-secret  --namespace <namespace> \
 --from-literal=instana-key='<instana agent key>'  \
 --from-literal=redis-password='<redis password>'  \
 --from-literal=proxy-user-pass='<proxy username and password>'  

附註: 您需要將 <namespace> 取代為您用來安裝虛構 PoP的名稱空間。

downloadKey 金鑰的密碼必須使用 kubernetes.io/dockerconfigjson 類型。 您可以使用 kubernetes.io/dockerconfigjson 類型來建立密鑰，如下所示:

kubectl create secret docker-registry my-pull-secret --namespace <namespace> --docker-server="https://containers.instana.io" --docker-username="_" --docker-password="<downloadKey>" 

附註：

• 將 <namespace> 取代為您用來安裝 Synthetic PoP的名稱空間。
• 請勿變更 --docker-username 引數的值。
• 將 <downloadKey> 取代為 Instana 下載金鑰。

虛構 PoP 感應器

若要監視虛構 PoP，建議您 在 PoP 安裝所在的 Kubernetes 叢集上安裝 Instana 主機代理程式 。

安裝 Instana 主機代理程式之後，會自動安裝 虛構 PoP 感應器 來監視 PoP 。 您可以在 Instana 使用者介面中檢視度量值，並在 Synthetic PoP發生任何性能問題時取得警示。

將 PoP 控制器 Pod 指派給固定節點

當您升級具有多個節點之 Kubernetes 叢集中的虛構 PoP 時， PoP 控制器 Pod 可能會指派給不同於您預期的節點。 如果 PoP 控制器指派給不同的節點，則 PoP entityId 會變更。 因為資料與 POP entityId相關聯，所以 PoP 儀表板中的監視資料遺失。

若要防止此問題，請在升級或安裝虛構 PoP之前，將 PoP 控制器 Pod 指派給已修正節點。

若要將 PoP 控制器指派給固定節點，請完成下列步驟:

1. 執行下列指令，將標籤新增至節點:

   kubectl label nodes <yournode> scheduler=synthetic-pop-controller
   

2. 在 helm install 或 helm upgrade 指令中指定下列參數: --set controller.nodeSelector.enabled=true

若要將 PoP 控制器 Pod 指派給固定節點，並從此節點中排除其他 Pod ，請完成下列步驟:

1. 執行下列指令，將污染新增至節點:

   kubectl taint nodes <yournode> toleration=synthetic-pop-controller:PreferNoSchedule
   

2. 在 helm install 或 helm upgrade 指令中指定下列參數: --set controller.taintSelector.enabled=true