Cài đặt playground plutus tại local
Xây dựng môi trường nhà phát triển Plutus trên Ubuntu 20.04
Chi tiết
Xây dựng môi trường Plutus Dev sử dụng (các) Kết quả mong muốn của Oracle VM VirtualBox Môi trường dành cho nhà phát triển làm việc cho Plutus
Tài nguyên
Cấu hình máy tính tốt: Máy tính cài phần mềm VM virtualBox 32 GB ram Hơn 100 GB dung lượng ổ cứng Hình ảnh với phần mềm Ubuntu Desktop 20.04
Ghi chú
Các hướng gẫn này hoạt động kể từ ngày 5/12/2021. Mọi thứ sẽ thay đổi theo thời gian. Vui lòng luôn kiểm tra kho lưu trữ github được liệt kê bên dưới để biết hướng dẫn cập nhật và bất kỳ thay đổi. Những hướng dẫn này không tuân theo hướng dẫn trên github như đã liệt kê, nhưng đây là cách tôi có thể làm cho mọi thứ hoạt động. Một trong những vấn đề khó khăn nhất trong buổi học đầu tiên là làm cho nó hoạt động, đây chỉ là cách tôi đã làm được. có những lựa chọn khác.
Các hướng dẫn sẽ được chia thành 3 phần. Phần đầu tiên hướng dẫn bạn cách cài đặt Haskell và các thành phần cần thiết trực tiếp vào máy ảo. Phần thứ hai hướng dẫn bạn cách cài đặt các tệp nhị phân nix-shell và Plutus cần thiết để chạy sân chơi plutus. Phần ba tạo sân chơi plutus.
Bạn cũng có thể sử dụng nix-shell cho bài tập về nhà của mình. Nếu bạn quyết định làm điều đó, Bạn có thể bỏ qua cài đặt Haskell.
Phần 1: Cài đặt Haskell
1) Tạo máy ảo với ít nhất 8 GB ram và 100 GB dung lượng lưu trữ. Đảm bảo rằng bạn chọn Ubuntu 64.
2) Bắt đầu chạy VM
3) Chọn hình ảnh VM cho ubuntu 20.04
4) Thực hiện quy trình bình thường để cài đặt ubuntu trên hệ thống của bạn (VM)
Sau khi bạn vào ubuntu của mình:
1) cập nhật và nâng cấp phần mềm:
sudo apt update
sudo apt upgrade -y
2) Cài đặt haskell
sudo apt-get install haskell-platform
3) Cài đặt ghcup và tất cả các tùy chọn (ghcup giúp dễ dàng di chuyển giữa các phiên bản của haskell, v.v.)
canh 1:
sudo apt install curl
sudo apt install build-essential curl libffi-dev libffi6 libgmp-dev libgmp10 libncurses-dev libncurses5 libtinfo5 libsodium-dev
curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh
Cach 2:
1 Install Cabal version 3.2.0.0 to our local bin folder (.local/bin)
sudo whoami
cd
wget https://downloads.haskell.org/~cabal/cabal-install-3.2.0.0/cabal-install-3.2.0.0-x86_64-unknown-linux.tar.xz
tar -xf cabal-install-3.2.0.0-x86_64-unknown-linux.tar.xz
rm cabal-install-3.2.0.0-x86_64-unknown-linux.tar.xz cabal.sig
mkdir -p ~/.cabal/bin
mv cabal ~/.cabal/bin/
2 Installing GHC 8.10.2 version - The Glorious Glasgow Haskell Compilation System (cardano node is based on the Haskell programming language)
sudo whoami
cd
wget https://downloads.haskell.org/ghc/8.10.2/ghc-8.10.2-x86_64-deb9-linux.tar.xz
tar -xf ghc-8.10.2-x86_64-deb9-linux.tar.xz
rm ghc-8.10.2-x86_64-deb9-linux.tar.xz
cd ghc-8.10.2
./configure
sudo make install
cd
3 Update PATH NODE
echo export PATH=~/.cabal/bin:$PATH >> ~/.bashrc
source ~/.bashrc
echo $PATH
export LD_LIBRARY_PATH="/usr/local/lib:$LD_LIBRARY_PATH"
export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH"
echo export CNODE_HOME=/opt/cardano/cnode >> $HOME/.bashrc
echo export CARDANO_NODE_SOCKET_PATH="$CNODE_HOME/sockets/node0.socket" >> $HOME/.bashrc
source ~/.bashrc
Điều này có thể mất một thời gian
KHỞI ĐỘNG LẠI VM ĐẦU TIÊN
ghc --version
-- Nó phải là: 8.10.4
cabal --version
-- Nó phải là: 3.4.0.0
4) Nhân bản plutus và thư mục tiên phong plutus. Bạn có thể đặt chúng ở bất cứ đâu. tôi đã tạo một thư mục riêng biệt để đưa chúng vào:
sudo apt install git
mkdir cardano
cd cardano
git clone https://github.com/input-output-hk/plutus
git clone https://github.com/input-output-hk/plutus-pioneer-program
-- Bây giờ bạn có mọi thứ bạn cần để chỉnh sửa hợp đồng thông minh và chạy chúng với giao diện dòng lệnh
-- Bạn phải chạy cập nhật cabal và xây dựng cabal trước khi bắt đầu ở một phần khác của bài tập về nhà
-- Lần đầu tiên bạn chạy xây dựng cabal sẽ mất nhiều thời gian ...
-- Bây giờ bạn cũng có thể chạy repl và test haskel - hầu hết tất cả các ví dụ này đều có trong video bài học đầu tiên
Phần 2: Cài đặt nix-shell
-- Bây giờ chúng ta sẽ cài đặt nix
1) Chúng ta cần cài đặt bộ nhớ đệm
Tạo thư mục /etc/nix/:
sudo mkdir /etc/nix
Sử dụng trình chỉnh sửa mã để đưa nội dung sau vào tệp có tên nix.conf trong thư mục nix (/etc/nix/nix.conf):
substituters = https://hydra.iohk.io https://iohk.cachix.org https://cache.nixos.org/
trusted-public-keys = hydra.iohk.io:f/Ea+s+dFdN+3Y/G+FDgSq+a5NEWhJGzdjvKNGv0/EQ= iohk.cachix.org-1:DpRUyj7h7V830dp/i6Nti+NEO2/nhblbov/8MW7Rqoo= cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY=
experimental-features = nix-command flakes
2) Cài đặt nix
curl -L https://nixos.org/nix/install | sh
Sau khi bạn cài đặt nix, hãy đảm bảo cài đặt các biến môi trường. Nó sẽ cho bạn biết làm thế nào sau khi cài đặt xong nix. nó sẽ giống cái này
Như thế này . /home/(user)/.nix-profile/etc/profile.d/nix.sh
bạn cũng có thể cần thêm nix vào Đường dẫn của mình. Tôi thực hiện bằng cách thêm ~/.nix-profile/bin vào file /etc/environment. Sau đó bạn khởi động lại Máy tính
Để nó hoạt động
3) Chạy lệnh nix trong thư mục Plutus::
Trước khi chạy lệnh nix-build sau, hãy đặt thẻ trong plutus trở lại thẻ ban đầu (3746610e53654a1167aeb4c6294c6096d16b0502) từ ngày học đầu tiên. Điều này đã giải quyết được sự cố mà tôi đang gặp phải với ứng dụng Client không biên dịch chính xác với các sáng tạo môi trường nhà phát triển mới hơn.
~/cardano/plutus $ git checkout 3746610e53654a1167aeb4c6294c6096d16b0502
~/cardano/plutus $ nix build -f default.nix plutus.haskell.packages.plutus-core.components.library
-- Điều này sẽ mất nhiều thời gian và bạn sẽ nhận được cảnh báo về việc: dumping very large path. Bạn có thể bỏ qua điều đó.
-- Sau khi hoàn tất, mọi thứ đã được cài đặt ngoại trừ trình chỉnh sửa mã bạn sẽ sử dụng
-- Lần đầu tiên bạn chạy nix-shell, nó cũng sẽ mất một lúc
-- video đầu tiên hướng dẫn bạn cách khởi động ứng dụng và máy chủ sân chơi plutus
Phần 3: Tạo sân chơi Plutus
Điều trên sẽ thiết lập môi trường của bạn với các phụ thuộc cần thiết để biên dịch các hợp đồng mẫu.
Khi bạn đã ở bên trong Nix shell, bạn có thể khởi động máy khách và máy chủ Plutus từ kho lưu trữ Plutus của bạn.
Các video bài giảng được ghi lại vào nhiều thời điểm khác nhau và mã Plutus cùng với chúng được biên soạn dựa trên các cam kết cụ thể của nhánh chính của Plutus. Bạn có thể tìm thấy thẻ cam kết trong tệp cabal.project.
-- Bạn mở 2 terminal một cho server và một cho client
Server
Tại terminal 1 bạn chạy:
cd cardano/plutus
. /home/nvhieu/.nix-profile/etc/profile.d/nix.sh
nix-shell
cd plutus-playground-server
plutus-playground-server
Client
Tại terminal 2 bạn chạy:
cd ~/cardano/plutus
. /home/nvhieu/.nix-profile/etc/profile.d/nix.sh
nix-shell
cd plutus-playground-client
npm run start
Biên dịch
Để kiểm tra xem mọi thứ có theo thứ tự hay không, sau đó bạn có thể biên dịch mã cho week01. Điều này không cần thiết để chạy mã trong sân chơi, vì sân chơi có thể tự biên dịch mã.
cd /path/to/plutus-pioneer-program/repo/code/week01
cabal build all
Nếu mọi thứ suôn sẻ trong thiết lập ở trên, bạn sẽ có thể mở sân chơi tại https://localhost:8009. Bạn có thể sẽ nhận được lỗi chứng chỉ, lỗi này có thể được bỏ qua.