srtool

Substrate WebAssembly 런타임을 빌드하기 위한 Docker 컨테이너와 명령줄 인터페이스에 대해 설명합니다.

Substrate 런타임 도구 상자(srtool)의 핵심 구성 요소는 Substrate WebAssembly 런타임을 결정론적인 방식으로 빌드할 수 있게 해주는 Docker 컨테이너입니다. 이 도구를 사용하면 동일한 소스 코드가 항상 동일한 WebAssembly blob을 재현한다는 것을 보장할 수 있습니다. 또한 이 도구를 사용하여 Substrate 기반 체인의 런타임을 검사하고 감사하며, WebAssembly 런타임 빌드를 CI/CD 파이프라인에 통합할 수도 있습니다.

Docker 컨테이너 사용하기

srtool은 Docker 컨테이너이므로 사용하려면 빌드 환경에 Docker가 설치되어 있어야 합니다. 그러나 srtool을 사용하여 체인을 빌드하는 데 Docker를 사용하는 방법에 대해 알 필요는 없습니다. srtool-cli 명령줄 인터페이스를 사용하여 Docker 이미지와 작업할 수 있습니다.

srtool-cli 패키지는 Rust로 작성된 명령줄 유틸리티로, 컴퓨터에 srtool이라는 실행 가능한 프로그램을 설치합니다. 이 프로그램은 srtool Docker 컨테이너와 상호 작용을 단순화합니다. srtool Docker 이미지를 사용하는 도구는 다음과 같은 도구와 도움 프로그램을 포함하고 있습니다:

srtool-cli는 srtool Docker 이미지를 가져오고 이미지와 상호 작용하는 데 사용되는 도구에 대한 명령줄 인터페이스를 제공합니다. 또한 srtool Docker 컨테이너를 사용하여 런타임을 빌드하는 기능도 제공합니다.
subwasm은 srtool을 사용하여 빌드된 메타데이터와 WebAssembly 런타임을 작업하는 데 사용되는 명령줄 옵션을 제공합니다. subwasm 프로그램은 srtool 이미지에서 작업을 수행하는 데에도 사용됩니다.
srtool-actions은 srtool 이미지로 생성된 빌드를 GitHub CI/CD 파이프라인에 통합하기 위한 Github 액션을 제공합니다.
srtool-app은 srtool Docker 이미지를 사용하여 런타임을 빌드하기 위한 간단한 그래픽 사용자 인터페이스를 제공합니다.

srtool-cli 설치하기

srtool 명령줄 인터페이스를 사용하여 srtool Docker 이미지를 사용하여 WebAssembly 런타임을 빌드할 수 있습니다. 다음 명령을 실행하여 srtool 명령줄 인터페이스를 설치할 수 있습니다:

cargo install --git https://github.com/chevdor/srtool-cli

기본 명령 사용법

srtool 명령을 실행하는 기본 구문은 다음과 같습니다:

srtool [options] [subcommand]

옵션

srtool 명령과 함께 다음 명령줄 옵션을 사용할 수 있습니다.

하위 명령

srtool 명령과 함께 다음 하위 명령을 사용할 수 있습니다.

예제

srtool Docker 이미지의 버전 정보를 가져오려면 다음 명령을 실행합니다:

srtool version

다음과 유사한 출력이 표시됩니다:

{
  "name": "srtool",
  "version": "0.9.21",
  "rustc": "1.62.0",
  "subwasm": "0.18.0",
  "tera": "0.2.1",
  "toml": "0.2.1"
}

srtool-cli 실행 파일의 버전 정보를 얻으려면 다음 명령을 실행합니다:

srtool --version

다음과 유사한 출력이 표시됩니다:

srtool-cli 0.8.0

srtool build

srtool build 명령을 사용하여 지정한 패키지의 런타임을 빌드하기 위해 새로운 srtool 컨테이너를 시작할 수 있습니다. 기본적으로 srtool build 명령은 런타임의 Cargo.toml 파일이 체인의 이름을 가진 runtime 하위 디렉토리에 위치해 있다고 가정합니다. 예를 들어, srtool build 명령은 기본적으로 다음 위치를 사용합니다:

runtime/kusama
runtime/polkadot
runtime/rococo
runtime/westend

런타임의 Cargo.toml 파일이 다른 위치에 있는 경우, 이를 명령줄 옵션으로 지정할 수 있습니다.

기본 사용법

srtool build 명령을 실행하는 기본 구문은 다음과 같습니다:

srtool build [options] --package <package> [--runtime-dir <path>] [project-path]

인수

기본적으로 srtool build는 현재 작업 디렉토리에서 실행됩니다. 프로젝트가 현재 작업 디렉토리에 없는 경우, 프로젝트 위치의 경로를 지정할 수 있습니다.

옵션

srtool build 명령과 함께 다음 명령줄 옵션을 사용할 수 있습니다.

예제

cumulus 리포지토리에서 parachains/runtimes/assets/asset-hub-westend 경로에 있는 Cargo.toml 파일을 사용하여 Westend 런타임을 빌드하려면 다음 명령을 실행합니다:

srtool build --app --package westmint-runtime --runtime-dir parachains/runtimes/assets/westmint

srtool build 명령을 처음 실행할 때는 완료까지 시간이 걸립니다. 런타임이 컴파일되는 동안 진행 상황에 대한 메시지가 표준 출력으로 표시됩니다. 이 예제에서는 --app 명령줄 옵션을 사용하므로 JSON 출력이 빌드의 끝에 한 줄로 표시됩니다. 다음은 일부 내용이 생략된 출력 예시입니다:

...
   Compiling cumulus-primitives-parachain-inherent v0.1.0 (/build/primitives/parachain-inherent)
   Compiling cumulus-pallet-parachain-system v0.1.0 (/build/pallets/parachain-system)
    Finished release [optimized] target(s) in 112m 11s
✨ Your Substrate WASM Runtime is ready! ✨
{"gen":"srtool v0.9.21","src":"git","version":"1.0.0","commit":"bd41e3f11887ea2f55fc37be71ff652923388e03","tag":"v0.9.220-rc2","branch":"master","rustc":"rustc 1.62.0 (a8314ef7d 2022-06-27)","pkg":"westmint-runtime","tmsp":"2022-08-22T21:12:18Z","size":"707937","prop":"0x6b8e93443b6660a16f67a6cd34d415af463e2285eda3fd02b9fe052c1ad2ceb9"
... }}}}

srtool help

srtool help 명령을 사용하여 srtool 또는 지정된 하위 명령에 대한 사용법 메시지를 표시할 수 있습니다.

기본 사용법

srtool help [subcommand]

예제

build 하위 명령에 대한 사용법 정보를 표시하려면 다음 명령을 실행합니다:

subkey help build

srtool info

srtool info 명령을 사용하여 srtool 컨테이너와 리포지토리에 대한 정보를 표시할 수 있습니다. 기본적으로 srtool info 명령은 런타임의 Cargo.toml 파일이 체인의 이름을 가진 runtime 하위 디렉토리에 위치해 있다고 가정합니다. 예를 들어, srtool info 명령은 기본적으로 다음 위치를 사용합니다:

runtime/kusama
runtime/polkadot
runtime/rococo
runtime/westend

런타임의 Cargo.toml 파일이 다른 위치에 있는 경우, 이를 명령줄 옵션으로 지정할 수 있습니다.

기본 사용법

srtool info 명령을 실행하는 기본 구문은 다음과 같습니다:

srtool info [options] --package <package> [--runtime-dir <path>] [project-path]

인수

기본적으로 srtool info는 현재 작업 디렉토리에서 실행됩니다. 프로젝트가 현재 작업 디렉토리에 없는 경우, 프로젝트 위치의 경로를 지정할 수 있습니다.

옵션

srtool info 명령과 함께 다음 명령줄 옵션을 사용할 수 있습니다.

예제

srtool 컨테이너와 로컬 node-template 리포지토리에 대한 정보를 표시하려면 다음과 유사한 명령을 실행할 수 있습니다:

srtool info --package node-template-runtime --runtime-dir runtime

다음과 유사한 출력이 표시됩니다:

{
  "generator": {
    "name": "srtool",
    "version": "0.9.21"
  },
  "src": "git",
  "version": "4.0.0-dev",
  "git": {
    "commit": "6a8b2b12371395979099d2c79ccc1860531b0449",
    "tag": "",
    "branch": "my-release-branch"
  },
  "rustc": "rustc 1.62.0 (a8314ef7d 2022-06-27)",
  "pkg": "polkadot-runtime",
  "profile": "release"
}

srtool pull

srtool pull 명령을 사용하여 srtool Docker 이미지의 최신 버전을 확인하고 다운로드할 수 있습니다.

기본 사용법

srtool pull 명령을 실행하는 기본 구문은 다음과 같습니다:

srtool pull [options]

옵션

srtool pull 명령과 함께 다음 명령줄 옵션을 사용할 수 있습니다.

예제

srtool 컨테이너와 Docker 이미지의 최신 버전을 확인하려면 다음과 유사한 명령을 실행할 수 있습니다:

srtool pull

이 명령은 Docker Hub에서 paritytech/srtool 이미지의 최신 버전을 확인하고 소프트웨어를 다운로드하고 추출하기 시작합니다. 예를 들어,

Found 1.62.0, we will be using paritytech/srtool:1.62.0 for the build
1.62.0: Pulling from paritytech/srtool
405f018f9d1d: Pull complete 
c49473e7f7b3: Pull complete 
7edf98d07029: Pull complete 
85a50724a6fa: Pull complete 
87fb1e3dee5b: Downloading   19.4MB/170.4MB
469075c5d317: Download complete 
533bfa44b64a: Download complete 
...

모든 작업이 완료되면 다음과 유사한 출력이 표시됩니다:

Digest: sha256:d5353a63d8fccbef5666e28a8fa0b302d71d4f53cabeb760fe213f3d7df4b8b6
Status: Downloaded newer image for paritytech/srtool:1.62.0
docker.io/paritytech/srtool:1.62.0

이미 최신 버전이 로컬에 설치되어 있는 경우, 다음과 유사한 출력이 표시됩니다:

Found 1.62.0, we will be using paritytech/srtool:1.62.0 for the build
1.62.0: Pulling from paritytech/srtool
Digest: sha256:d5353a63d8fccbef5666e28a8fa0b302d71d4f53cabeb760fe213f3d7df4b8b6
Status: Image is up to date for paritytech/srtool:1.62.0
docker.io/paritytech/srtool:1.62.0

srtool version

srtool version 명령을 사용하여 srtool 컨테이너의 버전 정보를 표시할 수 있습니다. srtool-cli 실행 파일의 버전을 얻으려면 --version을 사용하세요.

기본 사용법

srtool version 명령을 실행하는 기본 구문은 다음과 같습니다:

srtool version [options]

옵션

srtool version 명령과 함께 다음 명령줄 옵션을 사용할 수 있습니다.

예제

srtool 컨테이너에 대한 정보를 표시하려면 다음 명령을 실행합니다:

srtool version

다음과 유사한 출력이 표시됩니다:

{
  "name": "srtool",
  "version": "0.9.21",
  "rustc": "1.62.0",
  "subwasm": "0.18.0",
  "tera": "0.2.1",
  "toml": "0.2.1"
}

srtool-cli 실행 파일의 버전 정보를 표시하려면 다음 명령을 실행합니다:

srtool version --version

다음과 유사한 출력이 표시됩니다:

srtool-cli 0.8.0

Previous사이드카 Next서브키

Last updated 12 months ago