Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Threefold guides #76

Merged
merged 4 commits into from
May 3, 2023
Merged

Threefold guides #76

merged 4 commits into from
May 3, 2023

Conversation

Mik-TF
Copy link
Contributor

@Mik-TF Mik-TF commented May 1, 2023

In this pull request:

  • New embed link for DAO Voting
  • Added embed links for SSH videos (6 new videos)
  • Added section Remote Desktop and GUI
    • added 3 new guides: apache guacamole, xrdp and cockpit
  • Added new guide: nextcloud redundant deployment

The guides were first shared on the TF Forum.

@xmonader

Thanks!

@Mik-TF
Copy link
Contributor Author

Mik-TF commented May 3, 2023

@AhmedHanafy725
@ashraffouda
@mohamedamer453
@xmonader

Can you check this pull request please?

Also, the reviewers haven't approved yet this PR but I have the option on my side to merge it.
As @brandonpille proposed (on TG) we should change settings on Github to not allow merging if no one approved.

Thanks!

Copy link
Contributor

@mohamedamer453 mohamedamer453 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Everything looks good I've only found and commented on a couple of things that could be improved but other than that everything else is great.

I've also wanted to mention that i tried these guides while reviewing and they're really useful and easy to follow. Great Work!


## Conclusion

You now have access to a web-based graphical interface to manage your 3node. Read [Cockpit's documentation](https://cockpit-project.org/documentation.html) to explore further this interface.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

manage your 3node

Shouldn't it be VM instead of 3node? since it might be falsely understood that this guide gives you an interface to manage the node itself.

. /etc/os-release && sudo apt install -t ${UBUNTU_CODENAME}-backports cockpit -y
```
* Access Cokcpit on a web browser:
* Write the following URL with the 3node IP address:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as the comment mentioned below i think it should be changed to VM ip address or 3node VM ip address


## Introduction

In this guide, we deploy a full virtual machine (Ubuntu 20.04) on the Threefold Grid with IPv4. We install and run [Apache Guacamole](https://guacamole.apache.org/) and access the 3node server with remote desktop connection by using [xrdp](https://www.xrdp.org/).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment as above for the 3node naming should be applied in the following lines:
18, 38, 41, 72, 74, 97, 150, 160

* Deploy a Full VM (Ubuntu 20.04)
* IPv4 Address
* After deployment, copy the IPv4 address
* To SSH into the 3node, write in the terminal
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment as above for the 3node naming should be applied in the following lines:
28, 109, 136, 138, 155, 156

@@ -47,6 +47,10 @@ The main steps for the whole process are the following:

### SSH into a 3node with IPv4 on Linux
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment as above for the 3node naming should be applied in the following lines:
48, 51, 96, 99, 154, 157, 206, 209, 266, 269,323, 326


In this Threefold Guide, we show how easy it is to deploy a full VM and access Cockpit, a web-based interface to manage servers. For more information on Cockpit, visit this [link](https://cockpit-project.org/).

For more information on deploying a Full VM and using SSH remote connection, read [this SSH guide](https://www2.manual.grid.tf/getstarted/ssh_guide/ssh_guide.html).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have a question about the links of the docs. since these guides are the same project and repo, i think it would be better if we could redirect to it internally like this ../../tfgrid3_getstarted.md instead of adding an external link for the docs. or are these links added like this for a specifics reason?

this comment should also be applied for the links in the following lines: 18, 24,

Comment on lines 24 to 26
This guide can be done on a Windows, MAC, or Linux computer. For more information on deploying a Full VM and using SSH remote connection, read this [SSH guide](https://www2.manual.grid.tf/getstarted/ssh_guide/ssh_guide.html).

If you are new to the Threefold ecosystem and you want to deploy workloads on the Threefold Grid, read the [Get Started section](https://www2.manual.grid.tf/getstarted/tfgrid3_getstarted.html) of the Threefold Manual.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment as mentioned above for the links


### SSH into the 3nodes

* To [SSH into the 3nodes](https://www2.manual.grid.tf/getstarted/ssh_guide/ssh_guide.html), write the following:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment as mentioned above for the links

@Mik-TF
Copy link
Contributor Author

Mik-TF commented May 3, 2023

@mohamedamer453
Thanks a lot for the great advice.

I changed 3node for VM throughout, to avoid confusion.

I also set the proper inner links instead of the hyperlinks.
I will always have such inner links for future guides.

I will merge the PR.

@Mik-TF Mik-TF merged commit 6464453 into development May 3, 2023
@Mik-TF Mik-TF deleted the threefold_guides branch May 6, 2023 01:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants