자동화 작업 문제 감지 센서 활성화 및 구성

센서를 사용으로 설정하기 전에 다음 전제조건이 충족되는지 확인하십시오.

• ‘자동화 프레임워크를 안전하게 사용하는 방법’에 있는 내용을 확인하십시오.
• 클라우드 환경: 이슈 센서 버전 1.0.58 이하를 사용하는 경우, 해당 센서가 이슈 자동화 커넥터 이미지를 사용하므로 Instana 에이전트에서 Docker 또는 Podman 와 같은 컨테이너 관리 엔진을 사용할 수 있습니다.
• 자체 호스팅 (온프레미스) 환경: 자동화 기능 플래그 가 사용으로 설정되어 있습니다.

자동화 조치 실행 센서는 기본적으로 사용 안함으로 설정되어 있습니다. 센서를 활성화하려면 다음 예시와 같이 에이전트 구성 파일 ( instanaAgentDir /etc/instana/configuration.yaml)을 업데이트하십시오

com.instana.plugin.action.issue:
  enabled: true # by default is false

센서는 자동화 커넥터 이미지를 사용하여 원하는 작업을 수행하는 GitHub, GitLab, 및 Jira에 연결합니다. 자동화 커넥터 이미지는 센서가 활성화될 때 icr.io/instana/actions 레지스트리에서 가져옵니다.

에이전트 시스템이 이미지 icr.io 레지스트리에 액세스할 수 없는 경우, 센서 구성에서 해당 offline=true 설정을 지정하고 자동화 커넥터 이미지를 에이전트 시스템의 로컬 레지스트리에 로드하십시오.

자동화 커넥터를 구성하려면 다음 예제에 표시된 대로 에이전트 구성 파일을 업데이트하십시오.

com.instana.plugin.action.issue:
  enabled: true
  connector: # connector and its child attributes are required for issue sensor version 1.0.58 or older
    container_mgmt_engine: docker|podman # the container management engine
    host_port: 9080 # the port on the host to bind the connector container to
    ready_timeout: 60 # optional, default timeout is 300 seconds
    offline: false|true # optional, default is false

GitHub 실행 조치를 실행하도록 센서를 구성하려면 다음 예제에 표시된 대로 에이전트 구성 파일을 업데이트하십시오. 예시와 같이 볼트를 accessToken 사용하여 액세스 토큰을 보호하세요:

com.instana.plugin.action.issue:
  enabled: true
  github:
    baseUrl: <github_url> # i.e. https://api.github.com
    accessToken:
      configuration_from:
        type: vault
        secret_key:
          path: <secret_path>
          key: <secret_key>
  connector: # connector and its child attributes are required for issue sensor version 1.0.58 or older
    container_mgmt_engine: docker|podman # the container management engine
    host_port: 9080 # the port on the host to bind the connector container to
    ready_timeout: 60 # optional, default timeout is 300 seconds

일반 텍스트 토큰은 안전하지 않으므로 사용하지 마세요. 다음 예시는 구성에서 일반 텍스트 토큰을 사용하는 방법을 보여 주며 참고용으로만 제공됩니다.

com.instana.plugin.action.issue:
  enabled: true
  github:
    baseUrl: <github_url> # i.e. https://api.github.com
    accessToken: <github_access_token>
  connector: # connector and its child attributes are required for issue sensor version 1.0.58 or older
    container_mgmt_engine: docker|podman # the container management engine
    host_port: 9080 # the port on the host to bind the connector container to
    ready_timeout: 60 # optional, default timeout is 300 seconds

GitLab 이슈 작업을 실행하도록 센서를 구성하려면 다음 예와 같이 에이전트 구성 파일을 업데이트합니다. 다음 예시와 같이 accessToken 볼 트를 사용할 수 있습니다. accessToken에 볼트를 사용하는 것이 안전하며 선호됩니다.

com.instana.plugin.action.issue:
  enabled: true
  gitlab:
    baseUrl: <gitlab_url>
    accessToken:
      configuration_from:
        type: vault
        secret_key:
          path: <secret_path>
          key: <secret_key>
  connector: # connector and its child attributes are required for issue sensor version 1.0.58 or older
    container_mgmt_engine: docker|podman # the container management engine
    host_port: 9080 # the port on the host to bind the connector container to
    ready_timeout: 60 # optional, default timeout is 300 seconds

일반 텍스트 토큰은 안전하지 않으므로 사용하지 마세요. 다음 예시는 구성에서 일반 텍스트 토큰을 사용하는 방법을 보여 주며 참고용으로만 제공됩니다.

com.instana.plugin.action.issue:
  enabled: true
  gitlab:
    baseUrl: <gitlab_url>
    accessToken: <gitlab_access_token>
  connector: # connector and its child attributes are required for issue sensor version 1.0.58 or older
    container_mgmt_engine: docker|podman # the container management engine
    host_port: 9080 # the port on the host to bind the connector container to
    ready_timeout: 60 # optional, default timeout is 300 seconds

Jira 작업 액션을 실행하도록 센서를 구성하려면 다음 예시와 같이 에이전트 구성 파일을 업데이트하십시오. 다음 예시와 같이 apiToken vault 를 사용할 수 있습니다. apiToken에 볼트를 사용하는 것이 안전하며 선호됩니다.

com.instana.plugin.action.issue:
  enabled: true
  jira:
    baseUrl: <jira_url>
    username: <username>
    apiToken:
      configuration_from:
        type: vault
        secret_key:
          path: <secret_path>
          key: <secret_key>
  connector: # connector and its child attributes are required for issue sensor version 1.0.58 or older
    container_mgmt_engine: docker|podman # the container management engine
    host_port: 9080 # the port on the host to bind the connector container to
    ready_timeout: 60 # optional, default timeout is 300 seconds

일반 텍스트 토큰은 안전하지 않으므로 사용하지 마세요. 다음 예시는 구성에서 일반 텍스트 토큰을 사용하는 방법을 보여 주며 참고용으로만 제공됩니다.

com.instana.plugin.action.issue:
  enabled: true
  jira:
    baseUrl: <jira_url>
    username: <username>
    apiToken: <jira_api_token>
  connector: # connector and its child attributes are required for issue sensor version 1.0.58 or older
    container_mgmt_engine: docker|podman # the container management engine
    host_port: 9080 # the port on the host to bind the connector container to
    ready_timeout: 60 # optional, default timeout is 300 seconds

에이전트 시스템에 icr.io 이미지 레지스트리에 대한 액세스 권한이 없는 경우, 에이전트 시스템의 로컬 이미지 레지스트리에 이미지를 로드하십시오.

에이전트 시스템의 로컬 이미지 레지스트리에 이미지를 로드하려면 다음 단계를 완료하십시오.

1. 인터넷에 액세스할 수 있는 시스템에서 최신 Ansible 자동화 커넥터 이미지를 다운로드하십시오.

   docker pull icr.io/instana/actions/ticket:latest
   

2. 이미지를 아카이브 파일에 저장하십시오.

   docker save <image_id> > /tmp/ticket.tar
   

3. 아카이브를 에이전트 시스템에 복사한 후 이미지를 로컬 이미지 레지스트리에 로드하십시오.

   docker load < /tmp/ticket.tar
   

4. 이미지에 태그를 지정하십시오.

   docker tag <image_id> icr.io/instana/actions/ticket:latest
   

액션 카탈로그에 있는 ‘ GitHub 이슈’, ‘ GitLab 이슈’ 및 ‘Jira 태스크’ 액션이 Vault 매개변수를 사용하는 경우, 호스트 에이전트를 시크릿 관리자와 연동해야 합니다.