Skip to content

Translation 🌍

이 페이지를 번역하거나 기존 번역을 개선할 수 있습니다.

기여

로그

CLI는 문제를 진단하는데 도움이 되는 메세지를 내부적으로 기록합니다.

로그를 사용해 문제 진단

명령어 실행이 원하지 않는 결과가 나오면 로그를 확인해 문제를 진단할 수 있습니다. CLI는 로그를 OSLog와 파일 시스템으로 전달합니다.

각 실행마다 $XDG_STATE_HOME/tuist/logs/{uuid}.log 위치에 로그 파일을 생성하고, $XDG_STATE_HOME은 환경 변수가 설정되어 있지 않으면 ~/.local/state입니다.

기본적으로 CLI는 실행이 예기치 않게 종료되면 로그 경로를 출력합니다. 그렇지 않으면, 위에서 언급한 경로에서 로그를 확인할 수 있습니다.

WARNING

민감한 정보는 수정되지 않으므로 로그를 공유할 때 주의해야 합니다.

지속적 통합(CI)

환경이 일회성인 CI에서 CI 파이프라인이 Tuist 로그를 내보내도록 구성할 수 있습니다. 아티팩트(Artifact)를 내보내는 것은 대부분의 CI 서비스에서 공통적으로 지원하는 기능이며, 구성 방법은 서비스에 따라 다릅니다. 예를 들어 GitHub Actions에서는 actions/upload-artifact 액션으로 로그를 아티팩트로 업로드할 수 있습니다.

yaml
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

Released under the MIT License.