GitHub Actions로 변경 사항 추적

GitHub Actions 와 함께 New Relic 변경 사항 추적 기능을 사용하여 변경 사항이 고객과 시스템에 미치는 영향을 모니터링할 수 있습니다. GitHub Actions를 사용하면 모니터링할 변경 사항을 지정한 다음 New Relic UI에서 결과를 볼 수 있습니다. 이를 통해 릴리스 파이프라인 동안 환경에서 변경한 사항을 추적할 수 있습니다.

입력

입력 요소는 다음과 같습니다.

열쇠	필수의	기본값	설명
`guid`	예	해당 없음	변경 마커를 적용할 엔터티 GUID
`apiKey`	예	해당 없음	New Relic 개인 API 키
`changelog`	아니요	해당 없음	Change tracking [변경 내용 추적] 페이지에 표시되는 이 변경 내용에 대한 요약입니다.
`commit`	아니요	해당 없음	Change tracking [변경 사항 추적] 페이지에 표시되는 이 변경 사항에 대한 커밋 SHA
`description`	아니요	해당 없음	Overview [개요] 페이지와 개별 변경 사항을 선택할 때 Change tracking [변경 사항 추적] 페이지에 표시되는 이 변경 사항에 대한 대략적인 설명입니다.
`deeplink`	아니요	해당 없음	변경을 촉발한 소스에 대한 딥 링크
`deploymentType`	아니요	`BASIC`	배포 유형입니다. 기본값인 `BASIC` 외에 `BLUE_GREEN` , `CANARY` , `OTHER` , `ROLLING` 또는 `SHADOW`
`groupId`	아니요	해당 없음	다른 변경사항에 연결하기 위한 변경사항의 그룹 ID
`region`	아니요	`US`	New Relic 계정의 지역
`version`	예	해당 없음	최신 릴리스 태그와 같이 변경 마커에 적용할 메타데이터
`user`	예	`github.actor`	Overview [개요] 및 Deployments [배포] 페이지에 표시되는 변경 사항과 연결할 사용자 이름

사용 예

GitHub 비밀

다음 Github 비밀 이 설정되어 있는지 확인하십시오.

NEW_RELIC_API_KEY - 개인 API 키
NEW_RELIC_DEPLOYMENT_ENTITY_GUID - 마커를 생성하기 위한 New Relic Entity GUID

New Relic Application Deployment Marker 페이지를 확인하고 최신 버전 사용 버튼을 클릭하여 사용 가능한 최신 버전을 사용하고 있는지 확인합니다.

이 예제에서도 사용되는 여러 기본 GitHub 환경 변수 가 있습니다.

최소 필수 필드

name: Change Tracking Marker
on:
  release:
    types: [published]

jobs:
  newrelic:
    runs-on: ubuntu-latest
    name: New Relic
    steps:
      # This step builds a var with the release tag value to use later
      - name: Set Release Version from Tag
        run: echo "RELEASE_VERSION=${{ github.ref_name }}" >> $GITHUB_ENV
      # This step creates a new Change Tracking Marker
      - name: New Relic Application Deployment Marker
        uses: newrelic/deployment-marker-action@v2.3.0
        with:
          apiKey: ${{ secrets.NEW_RELIC_API_KEY }}
          guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID }}
          version: "${{ env.RELEASE_VERSION }}"
          user: "${{ github.actor }}"

모든 입력 필드

이 예는 NEW_RELIC_API_KEY 외에도 " NEW_RELIC_DEPLOYMENT_ENTITY_GUID_<ID> "과 같은 여러 비밀을 저장하여 여러 항목을 대상으로 지정하는 방법을 보여줍니다. 여기서 <ID> 는 대상 항목의 고유 식별자입니다.

NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App123
NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App456
NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App789

name: Change Tracking Marker
on:
  workflow_dispatch:
  release:
    types: [published]

jobs:
  newrelic:
    runs-on: ubuntu-latest
    name: New Relic
    steps:
      # This step builds a var with the release tag value to use later
      - name: Set Release Version from Tag
        run: echo "RELEASE_VERSION=${{ github.ref_name }}" >> $GITHUB_ENV
      # This step creates a new Change Tracking Marker for App123
      - name: App123 Marker
        uses: newrelic/deployment-marker-action@v2.3.0
        with:
          apiKey: ${{ secrets.NEW_RELIC_API_KEY }}
          guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App123 }}
          version: "${{ env.RELEASE_VERSION }}"
          changelog: "https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md"
          commit: "${{ github.sha }}"
          description: "Automated Release via Github Actions"
          deploymentType: "ROLLING"
          groupId: "Workshop App Release: ${{ github.ref_name }}"
          user: "${{ github.actor }}"
      # This step creates a new Change Tracking Marker for App456
      - name: App456 Marker
        uses: newrelic/deployment-marker-action@v2.3.0
        with:
          apiKey: ${{ secrets.NEW_RELIC_API_KEY }}
          guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App456 }}
          version: "${{ env.RELEASE_VERSION }}"
          changelog: "https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md"
          commit: "${{ github.sha }}"
          description: "Automated Release via Github Actions"
          deploymentType: "ROLLING"
          groupId: "Workshop App Release: ${{ github.ref_name }}"
          user: "${{ github.actor }}"
      # This step creates a new Change Tracking Marker for App789
      - name: App789 Marker
        uses: newrelic/deployment-marker-action@v2.3.0
        with:
          apiKey: ${{ secrets.NEW_RELIC_API_KEY }}
          guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App789 }}
          version: "${{ env.RELEASE_VERSION }}"
          changelog: "https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md"
          commit: "${{ github.sha }}"
          description: "Automated Release via Github Actions"
          deploymentType: "ROLLING"
          groupId: "Workshop App Release: ${{ github.ref_name }}"
          user: "${{ github.actor }}"

무엇 향후 계획

추적할 변경 사항을 지정한 후 New Relic UI에서 해당 변경 사항의 영향을 분석할 수 있습니다. 자세한 내용 은 New Relic에서 변경 사항을 보고 분석하는 방법을 참조하십시오.

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

입력

사용 예

GitHub 비밀

최소 필수 필드

모든 입력 필드

무엇 향후 계획