로깅

CLI는 내부적으로 메세지를 기록하여 문제 확인에 도움을 줍니다.

로깅 사용하여 문제 진단하기

명령어 수행이 원하는 결과를 가져오지 못한다면, 로그를 살펴보면서 문제의 원인을 파악해 볼 수 있습니다. CLI가 로그를 OSLog와 파일 시스템으로 전달해줍니다.

실행 시 마다, $XDG_STATE_HOME/tuist/logs/{uuid}.log경로에 로그 파일을 생성합니다. 환경 변수가 설정되어 있지 않다면, $XDG_STATE_HOME는 ~/.local/state로 되어 있습니다.

예기치 않게 실행이 종료되었을 때, 기본적으로 CLI는 로그 경로를 출력합니다. 만일 로그 경로가 출력되지 않았다면, 위에 명시된 경로에서 로그(가장 최근의 로그)를 확인할 수 있습니다.

[!중요] 민감한 정보는 지워지지 않으니, 로그를 공유할 때 주의하세요.

지속적인 통합

환경 설정이 일회용인 CI에서, Tuist 로그를 추출하기 위해서 CI 파이프라인 설정을 할 수 있습니다. 아티팩트(artifacts) 추출은 CI 서비스에서 일반적으로 사용되는 기능이고, 서비스맏 설정이 다릅니다. 예를 들어, 깃헙 액션(GitHub Actions)에서는 actions/upload-artifact 액션을 사용해서 로그를 아티팩트로 업로드할 수 있습니다:

name: Node CI

on: [push]

env:
  XDG_STATE_HOME: /tmp

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
      # ... other steps
      - run: tuist generate
      # ... do something with the project
      - name: Export Tuist logs
        uses: actions/upload-artifact@v4
        with:
          name: tuist-logs
          path: /tmp/tuist/logs/*.log