Update docs/hero_mdbook_fullvm.md

This commit is contained in:
mik-tf 2024-03-23 18:40:01 +00:00
parent 8f1dc01ea3
commit 5ca4b2e3d4

View File

@ -8,6 +8,9 @@
- [Set the SSH Key Pair](#set-the-ssh-key-pair)
- [Install hero, crysallib and V](#install-hero-crysallib-and-v)
- [Use Hero to Generate mdbooks](#use-hero-to-generate-mdbooks)
- [Troubleshooting](#troubleshooting)
- [Fix the error: "cli execution error: Cannot pull repo: /root/code/git.ourworld.tf/tfgrid/info\_tfgrid because there are changes in the dir."](#fix-the-error-cli-execution-error-cannot-pull-repo-rootcodegitourworldtftfgridinfo_tfgrid-because-there-are-changes-in-the-dir)
- [Fix: Git hangs at "Cloning into..."](#fix-git-hangs-at-cloning-into)
***
@ -23,6 +26,8 @@ We will be using SSH to connect to the VM and to create an SSH tunnel between th
To manage the mdbook files, we will be using the remote explorer feature of either VSCodium or VSCode.
We include some troubleshooting tips from testing the installation.
## Setting the Full VM
We start by deploying a full VM with WireGuard on the TFGrid. We also set an SSH tunnel.
@ -104,3 +109,28 @@ To see the mdbook online on a local browser (via the file **index.html**), run t
pushd /root/hero/www/info/tfgrid/; python3 -m http.server 5173; popd;
```
## Troubleshooting
### Fix the error: "cli execution error: Cannot pull repo: /root/code/git.ourworld.tf/tfgrid/info_tfgrid because there are changes in the dir."
Remove then rerun the command
```
rm -r /root/code/git.ourworld.tf/tfgrid/info_tfgrid
```
### Fix: Git hangs at "Cloning into..."
Run this command to fix this issue:
```
git config --global credential.provider generic
```
If it happens another time, you can try to download it manually:
```
mkdir -p /root/code/git.ourworld.tf/tfgrid && cd $_
git clone https://git.ourworld.tf/tfgrid/info_tfgrid
```