wiki: document gomote for first time users #31118
Labels
Documentation
Issues describing a change to documentation.
FrozenDueToAge
help wanted
NeedsFix
The path to resolution is known, but the work has not been done.
Milestone
Thanks for this. If there's one thing that could make the wiki significantly clearer it would be a paragraph about directory structure and the "gomote machine model". It took me a bunch of try-and-error runs to find out. Much of it may be "obvious" in retrospect, but it helps spelling it out right away, especially for first-time gomote users. This would provide newcomers a clearer model of how the gomote looks like from a client's perspective.
Some of the things that would be nice if they were spelled out:
$WORKDIR
rsync
of the$GOROOT
directory into the remote$WORKDIR
; i.e., after agomote push
, the local$GOROOT
appears asgo
directory on the gomote (I had to find this out by doing repeatedgomote ls
commands)gomote run
commands, one needs to specify the full path for commands and files, e.g.go/bin/go tool compile go/src/mypkg/x.go
- there appears no notion of acwd
, or perhaps I missed itgomote push $MOTE
and it will only upload the changes (this was not obvious to me at first, especially because there's also agomote put
command to push single files. I thought I was supposed to use that one for smaller changes)gomote put
to get a file into a specific directory on the gomote instance (I still don't know how to do it, but I resorted to just usinggomote push
all the time.)-system
flagOriginally posted by @griesemer in #31091 (comment)
The text was updated successfully, but these errors were encountered: