첫 번째 프로젝트 실행 이후 작업

첫 번째 프로젝트 실행 이후 작업

이제 Shotgun 데스크톱을 사용하여 첫 번째 프로젝트를 실행한 후의 작업에 대해 설명하겠습니다. 여기서는 공통 질문 및 주제를 다루고 유용한 문서 리소스를 소개합니다.
이 문서에서는 툴킷 구성에 대한 제어 권한이 있는 경우에만 사용할 수 있는 기능에 대해 설명합니다. 자세한 정보는 Shotgun 통합 사용자 안내서를 참조하십시오.

목차:

툴킷 소개

기초 구성

      응용프로그램 경로 설정

      Shotgun 통합

      Shotgun UI에 게시 추가

      다중 운영 체제

다음 단계

      툴킷 프로젝트 분석

            명령줄 액세스

            주요 구성 파일

            Core API 플랫폼

            추가 정보

      파이프라인 툴킷 커뮤니티

      지원 팀

툴킷 소개

툴킷 소개 이 문서를 읽고 있다면 Shotgun 데스크톱을 사용하여 첫 번째 Shotgun Pipeline Toolkit 프로젝트를 성공적으로 설치했다는 것을 의미합니다.

이 단계에서는 이미 프로젝트를 실행 중이고 위의 스크린샷처럼 여러 응용프로그램 시작 관리자가 있는 프로젝트 페이지가 표시되어 있어야 합니다. 이제 Maya, Nuke 또는 다른 응용프로그램을 열어 보십시오. 파일 및 에셋을 관리하기 위한 추가 기능이 있는 Shotgun 메뉴를 찾아야 합니다.

다음으로 수행할 작업은 무엇일까요? 툴킷은 구성 및 작동 방식 면에서 많은 유연성을 제공합니다. 이 문서에서는 Shotgun 데스크톱을 사용하여 첫 번째 프로젝트를 실행한 후에 수행하면 좋은 일부 단계에 대해 설명합니다.

기초 구성

이 섹션에는 구성에 필요한 여러 가지 조정 및 유용한 정보가 포함되어 있습니다. 첫 번째 툴킷 프로젝트를 방금 설정했다면 아마도 올바른 작동을 위해 여러 가지 설정을 조금씩 조정해야 할 것입니다. 이 섹션에서는 이러한 다양한 단계를 설명합니다. 이 중 일부는 구성 파일 편집 및 내부적으로 진행되는 작업과 관련이 있습니다. 질문이 있으면 언제든지 support@shotgunsoftware.com으로 문의해 주십시오.

응용프로그램 경로 설정

첫 번째 프로젝트를 설정하고 시작 버튼 중 하나를 클릭하여 Maya, Motionbuilder 또는 Nuke를 시작하면 다음과 같은 오류 메시지가 표시될 수 있습니다.

툴킷 프로젝트 구성에는 시작할 수 있는 다양한 실행 파일의 경로가 저장됩니다. 위의 메시지가 표시되면 해당 경로가 스튜디오 설정과 일치하지 않는 것일 수 있습니다. 또한 잘못된 버전의 응용프로그램이 시작되고 있음을 알 수 있습니다. 예를 들어 기본 구성에는 Maya 2015 경로가 있지만 스튜디오는 Maya 2014를 실행 중일 수 있습니다. 이 경우 경로를 변경해야 합니다.

기본 구성에서 이러한 경로는 모두 paths.yml이라는 단일 파일에 저장됩니다. 경로를 변경하려면 디스크에서 프로젝트 구성을 찾은 다음 paths.yml 파일을 찾을 때까지 config 폴더를 탐색합니다.

이 파일을 열고 경로를 원하는 대로 변경합니다. 파일을 저장한 후에는 Shotgun 데스크톱에 프로젝트를 그대로 두고 다시 클릭해야 합니다. 그러나 전체 응용프로그램을 다시 시작할 필요는 없습니다.

추가 정보

응용프로그램에 대한 자세한 정보는 다음 항목을 참조하십시오.

Shotgun 통합

툴킷은 Shotgun과 통합되며 UI의 다양한 부분에 특별한 툴킷 액션 메뉴 항목을 추가하여 기존 인터페이스를 확장합니다.

이는 응용프로그램을 시작하는 또 다른 방법을 제공하며 사용자는 Shotgun에서 직접 데이터를 조작하는 도구를 사용하거나 개발할 수도 있습니다. 이렇게 하려면 Shotgun 브라우저 플러그인을 설치해야 합니다. Shotgun 브라우저 플러그인은 Shotgun과 툴킷 간의 통신을 담당하는 특별한 브라우저 플러그인입니다. 이 시점에서 플러그인을 설치하는 것이 좋습니다. 소스 및 설치 프로그램을 포함한 자세한 정보는 https://github.com/shotgunsoftware/browser-plugin에서 확인할 수 있습니다.

기술 정보(확대하려면 클릭)


로컬 호스팅 사이트

참고: Shotgun 설치가 로컬인 경우, 즉 Shotgun 사이트 URL이 shotgunstudio.com으로 끝나지 않으면 브라우저 플러그인을 설치할 때 몇 가지 추가 단계를 수행해야 합니다. 자세한 정보는 https://github.com/shotgunsoftware/browser-plugin#security를 참조하십시오.


Java 기반 통합

이전에는 Java 애플릿을 사용하여 Shotgun과 툴킷 간의 통신을 관리했습니다. 지금도 Java를 계속 사용할 수 있으며 브라우저 플러그인을 설치하지 않으면 Shotgun이 자동으로 Java 애플릿으로 폴백합니다. 그러나 이 기능은 더 이상 사용되지 않을 예정이므로 더 빠르고 안정적인 브라우저 플러그인을 사용하는 것이 좋습니다.

Shotgun UI에 게시 추가

툴킷을 설치한 후에는 일반적으로 Shotgun UI 레이아웃을 약간 조정하는 것이 좋습니다. Shotgun Pipeline Toolkit은 파일을 게시할 때 게시 엔티티를 생성하므로, 샷 및 에셋과 같은 주요 에셋에 게시(Publishes) 탭을 추가하는 것이 편리합니다. 이렇게 하려면 관리자(admin)로 로그인해야 합니다. 에셋 또는 샷으로 이동하고 디자인 모드를 시작합니다.

이제 탭 중 하나에서 작은 메뉴 삼각형을 클릭하고 새 탭 추가(Add New Tab) 액션을 선택합니다. 그러면 대화상자 UI가 나타납니다. 게시(Publishes) 탭을 호출하고 게시된 파일(Published File) 엔티티와 연결되어 있는지 확인합니다.

이제 저장(Save)을 클릭하여 변경 사항을 저장합니다. 설정이 끝났습니다.

참고: 사용자가 새 탭을 만들 때 Shotgun은 몇 개의 기본 필드를 선택하여 가져옵니다. 게시할 필드를 몇 개 더 추가할 수 있습니다. 새 게시 탭에서 볼 수 있는 스프레드시트의 오른쪽 상단에 있는 작은 더하기 버튼을 클릭하면 됩니다. 다음 필드를 추가하는 것이 좋습니다.

  • 설명(Description) - 이 게시에서 변경한 사항에 대한 설명 저장
  • 만든 사람(Created by) - 게시를 만든 사용자
  • 만든 날짜(Date Created) - 게시를 만든 날짜

레이아웃을 변경하는 경우 완료 후 반드시 페이지를 저장해야 합니다.

다중 운영 체제

경우에 따라 설명서의 이 섹션에 대한 링크와 함께 Python을 찾을 수 없음(Python cannot be found)이라는 메시지가 표시될 수 있습니다.

툴킷은 Python이라는 언어를 사용하여 스크립트와 기능을 실행합니다. Shotgun 데스크톱은 완전한 Python 설치가 기본 제공되므로 일반적으로 신경쓸 필요가 없습니다. Shotgun 데스크톱을 사용하여 새 툴킷 프로젝트를 설정한 경우 프로젝트는 기본적으로 Shotgun 데스크톱과 함께 번들로 제공되는 Python을 사용하도록 설정됩니다. 그러나 툴킷에 Python을 사용하도록 명시적으로 알려야 할 때도 있습니다. 다음과 같은 경우를 예로 들 수 있습니다.

  • 모든 Python 기본값을 자동으로 설정하지 않는 이전 버전의 Shotgun 데스크톱을 사용할 경우
  • Shotgun 데스크톱을 디스크의 표준이 아닌 위치에 설치한 경우
  • 수동 또는 복잡한 툴킷 프로젝트 설정을 실행하는 경우

Python 경로는 수동으로 편집할 수 있는 구성 파일에 저장됩니다.

올바른 파일을 찾으려면 먼저 프로젝트 구성으로 이동합니다. 그런 다음 interpreter_로 시작하는 트리 파일을 찾습니다. 여기에는 Linux, Windows 및 Mac("Darwin")용 Python 인터프리터에 대한 경로가 포함되어 있습니다. 이러한 파일에는 세 가지 운영 체제 각각에 대한 Python의 위치가 들어 있습니다. 이제 사용하려는 운영 체제에 대한 Python 위치를 수동으로 추가해야 합니다.

파일이 비어 있으면 이전 버전의 Shotgun 데스크톱을 사용하고 있는 것입니다. 이 경우 빈 파일을 기본 Python 경로로 업데이트하십시오. 다음을 참조하십시오.

  • Macosx(Darwin): /Applications/Shotgun.app/Contents/Frameworks/Python/bin/python
  • Windows: C:\Program Files\Shotgun\Python\python.exe
  • Linux: /opt/Shotgun/Python/bin/python

Shotgun 데스크톱을 표준이 아닌 위치에 설치했거나 커스텀 Python 위치를 사용하려는 경우 파일의 경로가 유효한 Python 설치를 가리키는지 확인합니다. Python은 v2.6 이상이어야 합니다(단, Python 3 제외). UI 기반 응용프로그램과 도구를 실행하려면 지정한 Python에 PyQt 또는 PySide가 설치되어 있고 QT v4.6 이상에 링크되어 있는지 확인하십시오.

또한 여러 운영 체제에서 툴킷을 실행하려면 프로젝트 설정 마법사를 실행할 때 원하는 모든 플랫폼에 대한 경로를 지정해야 합니다. 이 작업을 수행하지 않고 저장소 경로 또는 구성 위치에 추가 운영 체제를 추가하려는 경우 support@shotgunsoftware.com으로 문의해 주시면 단계별로 안내해 드리겠습니다.

다음 단계

이제 Shotgun 프로젝트(또는 테스트 프로젝트)에서 기본 Shotgun 설정을 사용할 수 있습니다. 응용프로그램이 시작되고 상황에 맞는 메뉴 액션 및 게시가 Shotgun에 표시되고 항목이 원하는 운영 체제 플랫폼에서 작동합니다.

다음 섹션에서는 해당 기본 구성을 가져와 나머지 스튜디오 파이프라인처럼 작동하도록 조정하는 프로세스에 대해 설명합니다. 툴킷은 유연하고 상세한 구성이 가능하며 당사에서는 많은 문서를 제공합니다. 시작하기 전에 실제 모든 작동 방식을 확인하려면 몇 분 정도 시간을 내어 다양한 연습 동영상을 확인하는 것이 좋습니다. 이 동영상은 Shotgun Pipeline Toolkit이 Maya 및 Nuke와 같은 응용프로그램 내에서의 작동 방식을 보여 줍니다. 또한 게시, 버전 제어, 로딩 등과 같은 기본 개념도 설명합니다.

툴킷 프로젝트 분석

새로운 툴킷 프로젝트를 만들면 몇 가지 주요 위치에 구성됩니다.

  • Shotgun 데스크톱 및 해당 구성은 로컬 시스템에 설치됩니다. 원하는 경우 응용프로그램과 구성을 공유 저장소에 재배치할 수 있습니다.
  • 툴킷 프로젝트는 텍스처, 파일, 렌더링 등을 데이터 영역에 저장합니다. 이 데이터를 다른 사용자와 공유하기 때문에 일반적으로 이 영역은 공유 저장소에 있지만 이 규칙에는 예외가 있습니다. 사용자 작업 영역은 로컬(사용자 전용) 저장소에 저장할 수 있으며 Perforce 통합과 같은 통합은 외부 시스템을 사용하여 컨텐츠를 배포하는 데 도움이 됩니다.
  • 툴킷 구성은 코드, 앱, Core API 등을 비롯하여 완전한 자체 포함 번들입니다. 이 구성은 일반적으로 공유 저장소에 저장되므로 모든 사용자가 쉽게 액세스할 수 있습니다.

디스크의 프로젝트 구성에는 몇 가지 서로 다른 항목이 있습니다.

다음 섹션에서는 프로젝트 구성 폴더의 여러 부분을 살펴보겠습니다.

명령줄 액세스

Shotgun 데스크톱뿐만 아니라 터미널 또는 셸을 통해 툴킷에 액세스할 수도 있습니다. 디스크에 생성하는 각 프로젝트에는 API 세션 시작 및 응용프로그램 시작을 포함하여 많은 기능에 명령줄 기반으로 액세스할 수 있는 특수 tank 명령이 있습니다.

프로젝트 구성으로 이동하면 구성 루트에 tanktank.bat 명령이 표시됩니다. 옵션 없이 이러한 명령을 실행하면 다음의 유용한 명령을 포함하여 현재 구성에서 지원되는 모든 명령 목록을 확인할 수 있습니다.

  • tank shell - tk api 액세스 권한으로 대화형 Python 셸 시작
  • tank core - 이 프로젝트에 사용할 수 있는 Core API 업데이트가 있는지 확인
  • tank updates - 이 구성의 앱이나 엔진에 사용 가능한 업데이트가 있는지 확인

tank 명령을 사용하여 수행할 수 있는 작업에 대한 자세한 정보는 자세한 기술 문서를 참조하십시오.

주요 구성 파일

config 폴더에는 몇 가지 주요 구성 파일이 있습니다.

응용프로그램을 시작할 때 필요한 모든 구조가 디스크상에 있고 사전에 준비되도록 하기 위해 디스크에 폴더를 자동으로 만드는 폴더 생성 시스템이 툴킷과 함께 제공됩니다. 이에 대한 구성은 위에 표시된 schema 폴더에서 찾을 수 있습니다.

또한 툴킷 템플릿 시스템을 함께 사용하면 게시, 작업 파일, 렌더링 등 구성할 수 있는 파일에 대한 다양한 경로를 쉽게 정의할 수 있습니다. 이 항목은 위의 templates.yml 파일에 저장됩니다.

프로젝트 구성의 이 두 부분을 함께 사용하면 툴킷이 기존 파이프라인에서 이해할 수 있도록 디스크의 위치에 데이터를 기록하는 데 사용되는 다양한 앱을 조정할 수 있습니다. 자세한 정보는 다음과 같은 고급 문서를 참조하십시오.

기본적으로 툴킷은 구성된 앱 및 엔진의 모음으로 구성됩니다. 이 구성은 env 폴더에 있습니다. 위에 설명된 파일 시스템 구성 파일이 디스크상에서의 리소스 위치를 정의하면 해당 앱 및 엔진이 있는 환경 구성이 파이프라인이 수행해야 할 작업을 정의합니다.

Core API 플랫폼

각 프로젝트 구성은 앱 및 엔진의 컬렉션을 사용합니다. 이러한 앱 및 엔진의 구성은 구성 내의 env 폴더에 저장됩니다. 툴킷은 이러한 앱 및 엔진을 실행하는 데 필요한 다양한 버전의 코드를 자동으로 다운로드하고 관리합니다. 코드는 install 폴더 안에 있습니다.

구성, 앱 및 엔진은 모두 Toolkit Core 플랫폼 상단에서 실행됩니다. 새로운 프로젝트의 경우 install 폴더 내에도 저장됩니다. 기본적으로 프로젝트 구성은 완전하게 자체 포함되어 있습니다. 즉, 툴킷을 실행하는 데 필요한 모든 부분이 단일 위치에 있습니다. 또한 각 프로젝트가 독립적이며 하나의 프로젝트를 업데이트해도 다른 프로젝트가 중단되지 않는다는 것을 의미합니다.

기술 참고 사항: 공유 Toolkit Core 사용(클릭하여 확장)

많은 프로젝트를 실행 중이거나 다른 특정 요구 사항이 있는 경우 다중 프로젝트 간에 공유되는 단일 Core API를 실행할 수 있습니다. 이 워크플로우의 이점은 일련의 프로젝트에 영향을 주는 한 곳의 Core API만 업데이트하면 된다는 것입니다. 이는 툴킷 기본 동작이었으며 tank setup_project 명령을 실행하여 프로젝트를 설정하는 경우에도 작동하는 방법입니다.

툴킷에서는 자체 Core API를 유지 관리하는 프로젝트를 현지화된 구성이라고 합니다. Shotgun 데스크톱을 사용하면 모든 프로젝트가 기본적으로 현지화됩니다. 이 패턴을 벗어나려면 tank share_core를 실행하여 Core API를 프로젝트 구성에서 외부 위치로 이동하거나 또한 tank attach_to_core를 실행하여 구성에서 interla 툴킷 API를 제거하고 대신 기존 Core API에 연결합니다.

추가 정보

Shotgun Pipeline Toolkit의 개략적인 개념을 살펴보고 '전체적인 내용'을 설명하는 좀 더 기술적인 문서도 있습니다. 툴킷이 기본적으로 제공하는 기능을 잘 이해한 다음 이러한 문서로 옮겨가서 특정 스튜디오 요구 사항에 맞게 툴킷을 조정할 수 있는 방법을 더 깊이 이해하는 것이 좋습니다.

파이프라인 툴킷 커뮤니티

TD 및 파이프라인 엔지니어의 커뮤니티는 툴킷의 한 부분을 구성합니다. 우리는 강력하고 유연한 파이프라인 환경으로 툴킷을 함께 개선할 수 있는 역동적인 코드 공유 커뮤니티를 만드는 데 주력하고 있습니다.

궁금한 점이 있거나 기존 게시물 및 논의를 살펴보고 싶다면 공개 포럼 섹션을 방문하십시오.

지원 팀

마지막으로, 궁금한 점이 있거나 문제가 있다고 생각되면 언제든지 직접 문의해 주십시오. 당사는 실용적이고 편리하게 지원을 제공하기 위해 노력하고 있습니다. 예를 들어 버그를 발견한 경우 App Store를 통해 버그 수정 업데이트를 신속하게 제공할 수 있습니다. support@shotgunsoftware.com으로 문의해 주시면 기꺼이 도와드리겠습니다.

팔로우

0 댓글

댓글을 남기려면 로그인하세요.