docs: add a nodejs tutorial

[tigarmo]

The tutorial builds a simple "hello world" webapp and showcases using the npm plugin.

Fixes #369

• Have you signed the CLA?

---

[lengau]

Ran this in a fresh Jammy VM:

ubuntu@racy-chinook:~$ sudo lxd init --auto
ubuntu@racy-chinook:~$ sudo snap install docker
docker 20.10.24 from Canonical✓ installed
ubuntu@racy-chinook:~$ sudo snap install rockcraft --edge --classic
rockcraft (edge) 0+git.36080ac from Sergio Schvezov ⭐ (sergiusens) installed
ubuntu@racy-chinook:~$ mkdir my_rock
ubuntu@racy-chinook:~$ cd my_rock/
ubuntu@racy-chinook:~/my_rock$ mkdir src
ubuntu@racy-chinook:~/my_rock$ nano src/package.json
ubuntu@racy-chinook:~/my_rock$ nano src/server.js
ubuntu@racy-chinook:~/my_rock$ nano rockcraft.yaml
ubuntu@racy-chinook:~/my_rock$ nano rockcraft.yaml
ubuntu@racy-chinook:~/my_rock$ rockcraft pack

At this point it failed because of Docker being inconsiderate on the network.

Using the standard workaround:

sudo iptables -F FORWARD
sudo iptables -P FORWARD ACCEPT

I got further, but I hadn't prepped sufficient disk space, so I'll have to come back to it.

It's probably out of scope for this tutorial, but should we add some documentation for troubleshooting this particular issue? It seems like it'd be pretty common for Rockcraft in particular.

[lengau]

With the suggested changes above, it works. (Including not separately installing skopeo.)

[tigarmo]

@lengau while working on the review fixes I remembered that craft-parts has an npm plugin (doh), so in the interest of dogfooding it I updated the actual project to use it (it's now way simpler).

[cjdcordeiro]

Super neat! nice. thanks.

I only have one request, but it should be ok after that :)

[mr-cal]

Went through the tutorial, worked great for me!

[cjdcordeiro]

thanks for the changes

[SamirPS]

hello,

i have a feeling about the tutorial, so the application is pretty simple ( good point) but i think we can explain a little more the section we add on the rockcraft.yaml.

One example is the service section, we can say " this part is defined to do this.... and if you application crash....".

WDYT?

[tigarmo]

@SamirPS it's tough because a guideline of tutorials in Diátaxis is to keep explanations to a minimum, which is very hard to do sometimes. I already thought I put too much in but a tech author reviewed it and seems to be fine.

[SamirPS]

I checked with other people, and they said your tutorial is good. So I will only ask, if possible, could you please add the full rockcraft.yaml file at the end to help people to copy paste the yaml file.

[tigarmo]

Sure. I had to update the notation to extract the snippets so that the whole file is "clean", but I put the whole rockcraft.yaml file at the end of the "Project Setup" section

issues addressed