solana-test-validator-docker
v1.0.18
Published
Solana docker CLI to facilitate usages of solana-test-validator, cargo and anchor
Downloads
8
Maintainers
Readme
Develop on Solana easily with Docker
Do not install Rust, Solana and Anchor on the developer machine. You only need to install Docker.
Installation
npm install -g solana-test-validator-docker
Usage
Initialize .solrc configuration file
In order to mount a docker volume, a .solrc
configuration file needs to be created in the folder you want to be mounted.
{
"imageName": "tchambard/solana-test-validator:latest",
"containerName": "solana-test-validator"
}
The following command will create it.
solana-docker-shell init
Start container
Start the container. The directory where this command is executed must be somewhere in the project directory containing .solrc
file
solana-docker-shell start
Stop container
solana-docker-shell stop
Volumes
When starting the container, three volumes are mounted:
solana-docker:/opt Every tools needed are installed in
/opt
and mounted to named volumesolana-docker
. This volume makes rust/cargo installations and builds caches persistent.solana-docker-cache:/home/node/.cache Some solana caches are stored in user home directory
/home/node/.cache
and mounted to named volumesolana-docker-cache
. This volume makes solana caches persistent.${.solrc_directory}:/working_dir When running
solana-docker-shell init
, a configuration file.solrc
is created. The directory containing this file is mounted to/working_dir
.
How to execute a command inside solana-test-validator container
solana-docker-shell exec "solana-test-validator --ledger /opt/.config/solana/.ledger -r --bind-address 0.0.0.0 --rpc-port 8899"
solana-docker-shell exec "anchor --version"
solana-docker-shell exec "anchor build"
solana-docker-shell exec "cargo --version"
solana-docker-shell exec "yarn --version"
solana-docker-shell exec "solana --version"
solana-docker-shell exec "solana balance"
solana-docker-shell exec "solana airdrop 2"
...
But simplier, you can also use directly these commands:
# Launch solana-test-validator. Any options of classic command solana-test-validator are supported...
solana-test-validator-docker --ledger /opt/.config/solana/.ledger -r --bind-address 0.0.0.0 --rpc-port 8899
# Use anchor
anchor-docker --version
anchor-docker build
...
# or cargo
cargo-docker --version
cargo-docker build
...
# or yarn
yarn-docker --version
yarn-docker install
...
# or solana
solana-docker --version
solana-docker balance
solana-docker airdrop 2
...