> For the complete documentation index, see [llms.txt](https://korea-crypto-degen-club.gitbook.io/sui/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://korea-crypto-degen-club.gitbook.io/sui/undefined/running-fullnode.md). # 풀노드 실행하기 ## 풀노드 실행 방법 Sui 풀노드를 실행하는데 아래의 두가지 방법이 있습니다. * Docker 를 통해서 실행 (권장) * 소스를 빌드하여 실행 본 문서에서는 쉽게 따라할 수 있는 Docker 를 통해서 실행하는 방법을 권장드리며 이를 위주로 설명드리겠습니다. ## 풀노드 실행을 위한 소프트웨어 설치 Docker 를 통해서 Sui 풀노드를 실행하기 위해서 우리는 아래의 소프트웨어를 설치합니다. * Docker * Docker Compose docker 및 docker-compose 설치에 필요한 유틸리티를 다운받기 위해 아래의 명령어를 실행합니다. ``` sudo apt install apt-transport-https ca-certificates curl software-properties-common ``` ## Docker 설치 docker 리포지토리에 접근하기 위한 키 생성 설정 ``` curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - ``` 패키지 매니저가 docker 설치 시, 설치 위치를 알기 위한 repository 추가 ``` sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable" ``` 위에서 추가한 repository를 위해서 업데이트 ``` sudo apt update ``` docker 설치 ``` sudo apt install docker-ce ``` docker 설치가 잘 되었는지 확인합니다 ``` sudo systemctl status docker ``` 아래와 같이 출력되면 잘 설치 되었다고 판단합니다 ![](/files/fIniiJNIEKhchDh6hoJM) ## Docker Compose 설치 최신 버전을 [공식 Repository](https://github.com/docker/compose/releases) 에서 확인합니다. 문서 작성 기준 [v2.6.1](https://github.com/docker/compose/releases/tag/v2.6.1)이 최신이므로 아래의 명령어를 통해 설치합니다 ``` sudo curl -L "https://github.com/docker/compose/releases/download/v2.6.1/docker-compose-linux-x86_64" -o /usr/local/bin/docker-compose ``` (선택) 버전이 다른 경우 아래의 명령어와 같이 <최신 버전명> 부분에 버전명을 기입해서 실행해주세요. 아니라면, 아래의 명령어는 무시해주세요 ``` sudo curl -L "https://github.com/docker/compose/releases/download/<최신 버전명>/docker-compose-linux-x86_64" -o /usr/local/bin/docker-compose ``` docker-compose 를 실행이 가능하게 설정합니다 ``` sudo chmod +x /usr/local/bin/docker-compose ``` docker-compose가 잘 설치되었는지 아래 명령어를 통해 확인합니다 ``` docker-compose -v ``` 아래와 같이 출력되면 정상적으로 설치되었다고 판단합니다 ``` $ docker-compose -v Docker Compose version v2.6.1 ``` ## Docker 권한 부여하기 아래 명령어를 통해 권한 부여 ``` sudo groupadd docker \ && sudo usermod -aG docker $USER \ && newgrp docker ``` ## Sui 풀노드 실행하기 가장 최근 업데이트된 내용은 [공식 홈페이지](https://docs.sui.io/build/fullnode#using-docker-compose)를 기반으로 합니다. 따라서, 업데이트 내용과 차이가 있을 수 있습니다. Sui 풀노드 실행하기 위해서는 아래의 명령어를 통해 Sui 노드 관련 설정들을 다운로드 합니다. ``` mkdir -p ~/devnet \ && wget https://raw.githubusercontent.com/MystenLabs/sui/devnet/docker/fullnode/docker-compose.yaml -P ~/devnet \ && wget https://github.com/MystenLabs/sui/raw/main/crates/sui-config/data/fullnode-template.yaml -P ~/devnet \ && wget https://github.com/MystenLabs/sui-genesis/raw/main/devnet/genesis.blob -P ~/devnet ``` 위 명령어 실행 후, devnet 디렉토리에는 아래의 3가지 파일이 있어야 합니다. * docker-compose.yaml * fullnode-template.yaml * genesis.blob ### 풀노드 API 접근 허용 아래 명령어를 통해 API 접근을 허용합니다. ``` cd ~/devnet sed -i 's/127.0.0.1/0.0.0.0/' fullnode-template.yaml ``` ### 풀노드 실행하기 아래의 명령어를 통해 Sui 풀노드를 실행해주세요. ``` docker-compose up -d ``` ### 풀노드 작동 확인 아래의 명령어를 통해 Sui 풀노드가 잘 실행 되는지 확인합니다. ``` docker ps ``` #### 결과 ``` CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES d26352d61303 mysten/sui-node:stable "/usr/local/bin/sui-…" 3 minutes ago Up 3 minutes 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp, 0.0.0.0:9184->9184/tcp, :::9184->9184/tcp devnet-fullnode-1 ``` 최근 5개의 트랜잭션을 가져와서 확인합니다. ``` curl --location --request POST 'http://127.0.0.1:9000/' \ --header 'Content-Type: application/json' \ --data-raw '{ "jsonrpc":"2.0", "id":1, "method":"sui_getRecentTransactions", "params":[5] }' | jq ``` #### 결과 ``` $ curl --location --request POST 'http://127.0.0.1:9000/' \ --header 'Content-Type: application/json' \ --data-raw '{ "jsonrpc":"2.0", "id":1, "method":"sui_getRecentTransactions", "params":[5] }' | jq % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 389 100 310 100 79 53337 13592 --:--:-- --:--:-- --:--:-- 77800 { "jsonrpc": "2.0", "result": [ [ 17404, "ASFePe8TI+aGbosg94Gc2Dw6nYSPQaAPWFwuxuz6n5s=" ], [ 17405, "wr+VaXY6xuZcBDC1N8/pz0DP50aY4kynzIND2guZs/A=" ], [ 17406, "cDY5V2h4cgwxD4DX01dDs+fsB5ql2vEBcagslYEtJpM=" ], [ 17407, "jNNwzR48O5Ou06WcuN32WDgHUP2xGSVw9I8OTlzRBqY=" ], [ 17408, "JLia63qW7vtlEYMBSdNZ1mjFjDHBQdV72EbDtZSYPF4=" ] ], "id": 1 } ```