asset compute 작업자 디버깅

asset compute 작업자는 간단한 디버그 로그 명령문에서 원격 디버거로 연결된 VS 코드에 이르기까지 여러 가지 방법으로 디버깅할 수 있으며 AEM as a Cloud Service으로 시작한 Adobe I/O Runtime에서 활성화 로그를 가져올 수도 있습니다.

로깅

가장 기본적인 디버깅 Asset compute 작업자는 작업자 코드에서 기존의 console.log(..) 문을 사용합니다. console JavaScript 개체는 암시적 글로벌 개체이므로 모든 컨텍스트에 항상 있으므로 가져오거나 필요로 할 필요가 없습니다.

이러한 로그 문은 Asset compute 작업자 실행 방식에 따라 다르게 검토할 수 있습니다.

  • aio app run에서 로그를 표준 출력 및 개발 도구의 활성화 로그에 기록합니다
    aio app run console.log(...)
  • aio app test에서 로그는 /build/test-results/test-worker/test.log에 인쇄합니다.
    aio app test console.log(...)
  • wskdebug을 사용하여 로그 문은 VS 코드 디버그 콘솔(보기 > 디버그 콘솔)에 인쇄되며, 표준 출력
    wskdebug console.log(...
  • aio app logs을 사용하면 로그 명령문이 활성화 로그 출력에 인쇄됩니다

연결된 디버거를 통한 원격 디버깅

경고

wskdebug와의 호환성을 위해 Microsoft Visual Studio 코드 1.48.0 이상을 사용합니다

wskdebug npm 모듈은 VS 코드에서 중단점을 설정하고 코드를 단계별로 수행하는 기능을 포함하여 Asset compute 작업자에게 디버거를 연결할 수 있도록 지원합니다.

wskdebug(오디오 없음)를 사용하여 Asset compute 작업자를 디버깅하는 클릭스루

  1. wskdebug 및 ngroup npm 모듈이 설치되어 있는지 확인합니다.

  2. Docker Desktop 및 지원 Docker 이미지가 설치 및 실행 중인지 확인합니다.

  3. 개발 도구의 실행 중인 활성 인스턴스를 모두 닫습니다.

  4. aio app deploy 을 사용하여 최신 코드를 배포하고 배포된 작업 이름( [...] 사이에 이름)을 기록합니다. 이 값은 8단계의 launch.json을 업데이트하는 데 사용됩니다.

    ℹ Info: Deploying package [wkndAemAssetCompute-0.0.1]...

  5. npx adobe-asset-compute devtool 명령을 사용하여 Asset compute 개발 도구의 새 인스턴스를 시작합니다

  6. VS 코드에서 왼쪽 탐색에서 디버그 아이콘을 탭합니다

    • 메시지가 표시되면 launch.json 파일 만들기 > Node.js 를 탭하여 새 launch.json 파일을 만듭니다.
    • 그렇지 않은 경우 Launch Program 드롭다운 오른쪽에 있는 톱니바퀴 아이콘을 탭하여 편집기에서 기존 launch.json를 엽니다.

  7. 다음 JSON 개체 구성을 configurations 배열에 추가합니다.

    {
    "type": "pwa-node",
    "request": "launch",
    "name": "wskdebug",
    "attachSimplePort": 0,
    "runtimeExecutable": "wskdebug",
    "args": [
        "wkndAemAssetCompute-0.0.1/__secured_worker",  // Version must match your Asset Compute worker's version
        "${workspaceFolder}/actions/worker/index.js",  // Points to your worker
        "-l",
        "--ngrok"
    ],
    "localRoot": "${workspaceFolder}",
    "remoteRoot": "/code",
    "outputCapture": "std",
    "timeout": 30000
}

  8. 드롭다운에서 새 wskdebug​을(를) 선택합니다

  9. wskdebug 드롭다운 왼쪽에 있는 녹색 실행 단추를 누릅니다

  10. /actions/worker/index.js 을 열고 줄 번호의 왼쪽에 있는 를 탭하여 브레이크 포인트 1을 추가합니다. 6단계에서 열린 Asset compute 개발 도구 웹 브라우저 창으로 이동합니다

  11. 실행 단추를 눌러 작업자를 실행합니다

  12. VS 코드로 돌아가서 /actions/worker/index.js 로 이동하고 코드를 단계별로 진행합니다

  13. 디버그 가능 개발 도구를 종료하려면 6단계에서 npx adobe-asset-compute devtool 명령을 실행한 터미널에서 Ctrl-C을 누릅니다

Adobe I/O Runtime에서 로그 액세스

AEM as a Cloud Service은 Adobe I/O Runtime에서 직접 을 호출하여 처리 프로필을 통해 Asset compute 작업자를 활용합니다. 이러한 호출에는 로컬 개발이 포함되지 않으므로 Asset compute 개발 도구 또는 wskdebug와 같은 로컬 도구를 사용하여 해당 실행을 디버깅할 수 없습니다. 대신 Adobe I/O CLI를 사용하여 Adobe I/O Runtime의 특정 작업 공간에서 실행된 작업자로부터 로그를 가져올 수 있습니다.

  1. 작업 공간 관련 환경 변수가 디버깅이 필요한 작업 영역을 기반으로 AIO_runtime_namespace 및 AIO_runtime_auth을 통해 설정되었는지 확인합니다.

  2. 명령줄에서 aio app logs 실행

    • 작업 영역에 트래픽이 많이 발생하는 경우 --limit 플래그를 통해 활성화 로그 수를 확장합니다.

      $ aio app logs --limit=25

  3. 가장 최근(제공된 --limit) 활동 로그가 검토를 위한 명령의 출력으로 반환됩니다.

    aio 앱 로그

문제 해결

이 페이지에서는