fabric-samples/full-stack-asset-transfer-guide/docs/tips-for-windows-dev.md
jkneubuh a299e18e26
Moves the Full Stack Asset Transfer Development Guide to fabric-samples (#852)
* Import Full Stack Asset Transfer Guide at commit fb554befdbbeff9e69159b54fce0b811603f29c7

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>

* Update the workshop with a new WORKSHOP_PATH under fabric-samples

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>

* Update the workshop with a new WORKSHOP_PATH under fabric-samples

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>

* missed a .git ignored directory on add

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>

* Updates to run the workshop on the Apple M1

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>

* Workaround for https://github.com/eslint/eslint/issues/15299 in the contract tslinter

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>

* Build an arch-specific CC images on M1

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>

* empty commit - force a build

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>

* revert an accidental commit that was building the top-level asset-transfer as arm64

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>

Signed-off-by: Josh Kneubuhl <jkneubuh@us.ibm.com>
2022-11-10 10:40:27 -05:00

2.5 KiB

Using Windows

We recommend using the Windows Subsystem for Linux (WSL2) or use Multipass to create VMs. If you've never used either then Multipass is probably the quickest way to start initially.

Multipass

  • Setup Multipass on Windows (recommened to enable Hyper_V)
  • From a Windows Command Prompt
multipass launch --name fabric-dev --disk 80G --cpus 8 --mem 8G --cloud-init https://raw.githubusercontent.com/hyperledgendary/full-stack-asset-transfer-guide/main/infrastructure/multipass-cloud-config.yaml

Using VSCode

C:\Users\014961866>multipass list
Name                    State             IPv4             Image
primary                 Running           172.31.125.88    Ubuntu 20.04 LTS
fabric-dev              Running           172.31.118.103   Ubuntu 20.04 LTS
                                          172.17.0.1
  • You will need to find the private ssh key that multipass uses; this should be at C:\ProgramData\Multipass\data\ssh-keys\id_rsa
  • Copy this to you home directory (otherwise SSH will not use the file as it's 'too open')
copy C:\ProgramData\Multipass\data\ssh-keys\id_rsa %HOMEDRIVE%%HOMEPATH%\.ssh\multipass_id_rsa
  • In VSCode, click on the remote development icon in the toolbar, and in the Remote Explorer, choose SSH Targets
  • In the title bar of SSH Targets, click on the cog, and pick the default configuration file.
  • Create an entry in this configuration file
    • change the HostName to the IP of the multipass created VM
    • ensure the identity file points to the file you copied
    • you can change the fabric-dev name if you have multiple entries
Host fabric-dev
  HostName 172.31.118.103
  User ubuntu
  Port 22
  StrictHostKeyChecking no
  PasswordAuthentication no
  IdentityFile C:/Users/<your user>/.ssh/multipass_id_rsa
  IdentitiesOnly yes
  LogLevel FATAL
  • When save, an entry for fabric-dev will appear in the SSH Targets view
  • Click on the 'Open Window' icon next to it
  • First time you'll be asked to confirm the system is Linux, and VSCode will setup it's remote server.
  • Then you're good to go with browsing files, and also using the inbuilt terminal.