# 通过修改deployment.yaml的方式接入APM
如果使用CCE或开源Kubernetes部署应用，可以通过修改deployment.yaml接入APM，即可在指标、调用链界面上查看应用运行数据。
#### 前提条件
部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。
可使用**curl -kv** 命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域的连通性为例，请登录应用所部署的机器，并输入命令curl -kv 100.125.12.108:41333，其他区域地址请参考[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。
#### 编辑deployment.yaml文件并接入APM
1. 在volumes中增加一个emptyDir。 
   volumes:
   ```
   - name: paas-apm2
      emptyDir: {}
   ```
   
   
2. 在containers.volumeMounts中增加mountPath。 
   volumeMounts:
   ```
   - name: paas-apm2
      mountPath: /paas-apm2/javaagent/
   ```
   
   
3. 在env中增加JAVA_TOOL_OPTIONS环境变量。 
   env:
   ```
   - name: JAVA_TOOL_OPTIONS
      value: '-javaagent:/paas-apm2/javaagent/apm-javaagent/apm-javaagent.jar'
   ```
   
   
4. 新增initContainers。 
   ```
   initContainers:
     - name: init-javaagent
       image: {swrAddress}/op_svc_apm/javaagent:{agentVersion}
       command:
         - /bin/sh
         - '-c'
         - cd /paas-apm2/javaagent/apm-javaagent; /bin/sh init-config.sh -master_address {masterAddress} -app_name {appName} -access_key {accessKey} -access_value {secretKey} -business {business} -env {env}
       resources:
         limits:
           cpu: 250m
           memory: 250Mi
         requests:
           cpu: 250m
           memory: 250Mi
      volumeMounts:
         - name: paas-apm2
           mountPath: /var/init/javaagent
        terminationMessagePath: /dev/termination-log
        terminationMessagePolicy: File
        imagePullPolicy: Always
        monitorGroup: default
   ```
   表1参数说明 
   | 参数            | 参数说明                                                                                                                               |
   |:---|:---|
   | swrAddress    | 必填，探针镜像地址。组成方式为swr.{regionId}.myhuaweicloud.com，例如：上海一的swrAddress为swr.cn-east-3.myhuaweicloud.com。                                 |
   | agentVersion  | 必填，探针版本。参考[JavaAgent更新说明](https://support.huaweicloud.com/productdesc-apm2/apm_01_0093.html)，比如：2.4.8-x86_64。                      |
   | masterAddress | 必填，探针上报地址，可参考[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)获取，例如：上海一的接入地址为 https://100.125.4.27:41333。 |
   | appName       | 必填，组件名称。                                                                                                                           |
   | accessKey     | 必填，APM上报AK，获取方式请参考[管理APM访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。                                   |
   | secretKey     | 必填，APM上报SK，获取方式请参考[管理APM访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。                                   |
   | business      | 选填，所属应用名称。                                                                                                                         |
   | env           | 选填，环境名称，用于区分所属环境，可用于搜索和配置。                                                                                                         |
      
   
   
 
#### 配置示例
```
spec:
  replicas: 1
  selector:
    matchLabels:
      app: vmall-admin
      version: v1
  template:
    metadata:
      creationTimestamp: null
      labels:
        app: vmall-admin
        version: v1
    spec:
      volumes:
        - name: vol-171526714525730640
          hostPath:
            path: /vmall/vmall-deploy/vmall-data/app/vmall-admin/logs
            type: ''
        - name: paas-apm2
          emptyDir: {}
      initContainers:
        - name: init-javaagent
          image: swr.cn-north-4.myhuaweicloud.com/op_svc_apm/javaagent:2.4.8-x86_64
          command:
            - /bin/sh
            - '-c'
            - cd /paas-apm2/javaagent/apm-javaagent; /bin/sh init-config.sh -master_address https://***.***.**.***:**** -app_name vmall-admin -access_key {AK} -access_value {SK} -business vmall-demo
          resources:
            limits:
              cpu: 250m
              memory: 250Mi
            requests:
              cpu: 250m
              memory: 250Mi
          volumeMounts:
            - name: paas-apm2
              mountPath: /var/init/javaagent
          terminationMessagePath: /dev/termination-log
          terminationMessagePolicy: File
          imagePullPolicy: Always
          monitorGroup: default
      containers:
        - name: vmall-admin
          image: swr.cn-north-4.myhuaweicloud.com/vmall-org/vmall-admin:1.0.0
          env:
            - name: PAAS_APP_NAME
              value: vmall-admin
            - name: PAAS_NAMESPACE
              value: default
            - name: PAAS_PROJECT_ID
              value: e49731583bc54978aa7b4da1a2196e46
            - name: CLOUDDEPLOY_SYS_INCREMENT
              value: '1719279081896'
            - name: JAVA_TOOL_OPTIONS
              value: '-javaagent:/paas-apm2/javaagent/apm-javaagent/apm-javaagent.jar'
          resources:
            limits:
              cpu: '1'
              memory: 2Gi
            requests:
              cpu: 500m
              memory: 1Gi
          volumeMounts:
            - name: vol-171526714525730640
              mountPath: /var/logs
            - name: paas-apm2
              mountPath: /paas-apm2/javaagent/
          terminationMessagePath: /dev/termination-log
          terminationMessagePolicy: File
          imagePullPolicy: Always
      restartPolicy: Always
      terminationGracePeriodSeconds: 30
      dnsPolicy: ClusterFirst
      securityContext: {}
      imagePullSecrets:
        - name: default-secret
      schedulerName: default-scheduler
      tolerations:
        - key: node.kubernetes.io/not-ready
          operator: Exists
          effect: NoExecute
          tolerationSeconds: 300
        - key: node.kubernetes.io/unreachable
          operator: Exists
          effect: NoExecute
          tolerationSeconds: 300
```
#### 通过APM管理应用
应用启动后，等待3分钟应用数据就会呈现在APM界面中，此时登录APM，您可以在APM进行应用性能优化。