tw
명령줄의 Seqera 플랫폼입니다. 파이프라인, 작업 및 컴퓨팅 환경과 같은 Seqera 개념을 터미널에 제공합니다.
Seqera 플랫폼은 데이터 파이프라인 및 컴퓨팅 리소스 관리를 위한 풀스택 애플리케이션입니다. 이를 통해 온프레미스 또는 모든 클라우드에서 대규모로 공동 데이터 분석을 수행할 수 있습니다.
CLI는 Seqera와 상호 작용하여 파이프라인 실행, 클라우드 리소스 관리, 분석 관리를 위한 인터페이스를 제공합니다.
주요 기능은 다음과 같습니다.
Nextflow와 유사한 경험 : tw CLI는 개발자 친화적인 환경을 제공합니다. 파이프라인은 Nextflow와 유사하게 CLI를 사용하여 시작할 수 있지만 모니터링, 로깅, 리소스 프로비저닝, 데이터 세트 관리 및 협업 공유라는 Seqera 이점이 있습니다.
코드형 인프라 : 파이프라인 및 컴퓨팅 환경을 포함한 모든 Seqera 리소스는 선언적 방식으로 설명될 수 있습니다. 이를 통해 버전을 관리하고 코드로 처리할 수 있는 분석 환경을 완벽하게 정의할 수 있습니다. 이는 구성 공유 및 일상적인 관리를 크게 단순화합니다.
OpenAPI 기반 : tw CLI는 OpenAPI 3.0 사양을 사용하는 Seqera 플랫폼 API를 통해 Seqera와 상호 작용합니다. CLI는 Seqera 애플리케이션에 대한 전체 제어 기능을 제공하므로 사용자는 파이프라인 제출 및 실행 환경에 대한 최대한의 통찰력을 얻을 수 있습니다.
애플리케이션에 대해 자세히 알아보려면 Seqera 플랫폼 설명서를 참조하세요.
tw CLI는 macOS, Windows 및 Linux에 설치할 수 있습니다.
Seqera Cloud 및 Enterprise 버전 21.08 이상과 호환됩니다.
이 가이드에서는 CLI 설치 및 구성, 클라우드 인프라 프로비저닝, AWS Batch 컴퓨팅 환경으로의 파이프라인 시작을 다룹니다.
릴리스 페이지의 자산에서 해당 OS의 최신 버전을 다운로드하세요.
파일 이름을 바꾸고 실행 가능하게 만듭니다.
mv tw- * tw
chmod +x ./tw
$PATH
변수에 액세스할 수 있는 디렉터리로 파일을 이동합니다.
sudo mv tw /usr/local/bin/
CLI가 Seqera 인스턴스와 상호 작용하려면 액세스 토큰이 필요합니다. Seqera UI의 사용자 메뉴에서 사용자 토큰을 선택한 다음 토큰 추가를 선택하여 새 토큰을 만듭니다.
액세스 토큰 값을 복사하고 다음 두 가지 방법 중 하나로 CLI에서 사용합니다.
환경변수 :
토큰을 쉘 변수로 터미널에 직접 내보냅니다.
export TOWER_ACCESS_TOKEN= < your access token >
환경에 영구적으로 추가하려면 .bashrc
, .zshrc
또는 .bash_profile
파일에 export
명령을 추가하세요.
tw 명령 플래그 :
--access-token
사용하여 tw
명령에 직접 액세스 토큰을 제공하세요.
tw --access-token= < your access token > < other options >
필요한 경우 위와 동일한 방법을 사용하여 다음과 같은 비필수 환경 변수를 구성합니다.
TOWER_WORKSPACE_ID
: 작업공간 ID입니다. 기본값: 사용자 작업공간.TOWER_API_ENDPOINT
: Seqera API URL입니다. 기본값: api.cloud.seqera.io
.조직 페이지의 작업공간 탭에서
TOWER_WORKSPACE_ID
를 찾을 수 있습니다. 또는tw workspaces list
사용하여 토큰이 액세스할 수 있는 모든 작업 공간을 나열하고 명령 출력에서 작업 공간 ID를 복사할 수 있습니다.
설치, 구성 및 연결을 확인합니다.
$ tw info
System health status
---------------------------------------+------------------
Remote API server connection check | OK
Tower API version check | OK
Authentication API credential's token | OK
tw
CLI 명령CLI 사용에 대한 자세한 지침은 사용법을 참조하세요.
다음 명령을 사용하여 현재 세션에서 자동 완성을 활성화합니다.
source <( tw generate-completion )
기본 Java 인증 기관에서 인식되지 않는 사설 CA SSL 인증서를 사용하는 경우 사용자 정의 cacerts
저장소를 사용하십시오.
tw -Djavax.net.ssl.trustStore=/absolute/path/to/cacerts info
바이너리 이름을 tw-binary
로 바꾸고 tw
스크립트를 생성하여 모든 세션에 사용자 정의 cacerts
저장소를 자동으로 포함할 수 있습니다.
#! /usr/bin/env bash
tw-binary -Djavax.net.ssl.trustStore=/absolute/path/to/cacerts $@
tw CLI는 Java GraalVM의 기본 컴파일로 생성된 플랫폼 바이너리 실행 파일입니다. 바이너리의 개발 버전을 컴파일하고 빌드하려면 다음 안내를 따르세요.
필요한 경우 SDKMan을 설치하세요!
tower-cli 프로젝트의 루트에서 GraalVM을 설치합니다.
sdk env install
이렇게 하면 SDKMan이 tower-cli 프로젝트별 .sdkmanrc
구성을 사용하게 됩니다.
native-image
설치:
gu install native-image
Github 자격 증명을 내보냅니다. Github에서는 공개 패키지에 대한 인증이 필요합니다(토큰에는 read:packages
범위만 필요함).
export GITHUB_USERNAME=...
export GITHUB_TOKEN=...
네이티브 클라이언트를 생성합니다:
./gradlew nativeCompile
그러면 NativeCompile 디렉터리에 로컬로 컴파일된 tw
버전이 설치됩니다.
Produced artifacts:
<tower-cli-repository-root>/build/native/nativeCompile/tw (executable)
========================================================================================================================
Finished generating 'tw' in 1m 6s.
[native-image-plugin] Native Image written to: <tower-cli-repository-root>/build/native/nativeCompile
BUILD SUCCESSFUL in 1m 8s
6 actionable tasks: 2 executed, 4 up-to-date
tw
실행하세요:
./build/native/nativeCompile/tw
이 저장소의 루트에서 ./tw
스크립트를 실행하여 비바이너리 개발 버전을 실행합니다.
아파치 2.0