malfatti
/
Howto
forked from Disroot/Howto
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Merge pull request 'add info about language plugin in readme' (#53) from meazdev into master 

Update of the README file (added infor + Arch commands + MD style)
This commit is contained in:
Fede.- 2020-12-04 14:18:59 +00:00
parent 689416a6dc 183542cf01
commit 8a0f6b11b7
1 changed files with 165 additions and 100 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

265
vagrant/README.md
View File

@ -1,119 +1,184 @@
# This Vagrant setup is still Work in Progress, though it can be used as is. #### This Vagrant setup is still a "Work in Progress", though it can be used as is.
# Disroot Howto Development Environment using Vagrant # Disroot Howto Development Environment using Vagrant
## requirements ## Requirements
1. vagrant 2.2.6 * **Vagrant 2.2.6**
for install on Debian run commands:
```
wget https://releases.hashicorp.com/vagrant/2.2.6/vagrant_2.2.6_x86_64.deb
```
```
sudo dpkg -i vagrant_2.2.6_x86_64.deb
```
```
sudo apt install -f
```
2. virtuabox Commands for Vagrant installation
for install on Debian Jessie run command:
```
sudo apt install virtualbox-6.0
```
for install on Debian Buster run command: **On Debian based operating systems**
```
sudo echo 'deb http://download.virtualbox.org/virtualbox/debian buster contrib' > /etc/apt/sources.list.d/virtualbox.list
```
```
wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | sudo apt-key add -
wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- | sudo apt-key add -
```
```
sudo apt-get update ; sudo apt-get install virtualbox-6.0
```
3. vagrant plugins vagrant-vbguest: ```
for install on Debian run commands: wget https://releases.hashicorp.com/vagrant/2.2.6/vagrant_2.2.6_x86_64.deb
``` ```
vagrant plugin install vagrant-vbguest
```
4. git ```
``` sudo dpkg -i vagrant_2.2.6_x86_64.deb
sudo apt install git ```
```
## Installation ```
sudo apt install -f
```
1. Create a Disroot folder, in which you'll clone the repository: **On Arch based operating systems**
```
mkdir ~/Disroot
```
2. Clone howto repo to Disroot folder
```
git clone https://git.fosscommunity.in/disroot/howto.git ~/howto
```
3. Add the local domain name for the hub to your host machine's `/etc/hosts` file.
``` ```
echo "192.168.33.11 howto.disroot.lan" >> /etc/hosts sudo pacman -S vagrant
``` ```
4. Launch Vagrant to build the virtual machine (VM). This will take several minutes.
```
cd ~/Disroot/howto/vagrant
vagrant up howto_disroot_lan
```
Congratulations, you should now have a fully functioning apache+GRAV server running locally in a Virtualbox-hosted VM managed by Vagrant. Next time you want to run vagrant simply run command * **VirtuaBox**
```
cd ~/Disroot/howto/vagrant Commands for VirtuaBox installation
vagrant up howto_disroot_lan
vagrant provision **On Debian Jessie**
```
```
sudo apt install virtualbox-6.0
```
**On Debian Buster**
```
sudo echo 'deb http://download.virtualbox.org/virtualbox/debian buster contrib' > /etc/apt/sources.list.d/virtualbox.list
```
```
wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | sudo apt-key add -
wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- | sudo apt-key add -
```
```
sudo apt-get update ; sudo apt-get install virtualbox-6.0
```
**On Arch based operating systems**
```
sudo pacman -S virtualbox
```
* **Vagrant plugins vagrant-vbguest**
Commands for Vagrant plugins installation
```
vagrant plugin install vagrant-vbguest
```
* **Git**
Commands for git installation
**On Debian based operating systems**
```
sudo apt install git
```
**On Arch based operating systems**
```
sudo pacman -S git
```
## Installing the Vagrant virtual machine
1. Create the Disroot folder in which the repositories will be cloned, and enter it
```
mkdir ~/Disroot ; cd ~/Disroot
```
2. Clone the Howto repository inside the Disroot folder
```
git clone https://git.disroot.org/Disroot/Howto.git
```
3. Clone the grav-plugin-language-selector repository inside this same Disroot folder
```
git clone https://git.disroot.org/Disroot/grav-plugin-language-selector.git
```
4. Add the local domain name for the hub to your host machine's `/etc/hosts` file.
```
echo "192.168.33.11 howto.disroot.lan" >> /etc/hosts
```
5. Go to the Vagrant folder inside the cloned repository...
```
cd ~/Disroot/howto/vagrant
```
... and launch Vagrant to build the virtual machine (VM). This will take several minutes.
```
vagrant up howto_disroot_lan
```
**Congratulations!** You should now have a fully functioning Nginx + GRAV server running locally in a VirtualBox-hosted VM managed by Vagrant.
Next time you want to run Vagrant simply use the commands
```
cd ~/Disroot/howto/vagrant
vagrant up howto_disroot_lan
vagrant provision
```
### Enable SSH access ### Enable SSH access
To make your development workflow more efficient, you may wish to use an SSH connection to rapidly synchronize the files you are developing in your local (host machine) development environment. To make your development workflow more efficient, you may wish to use an SSH connection to quickly synchronize the files you are developing in your local (host machine) development environment.
1. On your host machine, copy your public key. 1. On your host machine, copy your public key.
```
user@host:~$ cat ~/.ssh/id_rsa.public ```
ssh-rsa eLX1UQbJHUCHf2V3K7YlMP0YmIT+50rlEsWre1eobApKb0Ac/WbvssX/Gh/ user@host user@host:~$ cat ~/.ssh/id_rsa.public
``` ssh-rsa eLX1UQbJHUCHf2V3K7YlMP0YmIT+50rlEsWre1eobApKb0Ac/WbvssX/Gh/ user@host
```
2. Use `vagrant ssh howto_disroot_lan` to log in to the virtual machine. 2. Use `vagrant ssh howto_disroot_lan` to log in to the virtual machine.
```
user@host:~$ cd ~/Disroot/howto/vagrant ```
user@host:hubzilla-vagrant$ vagrant ssh howto_disroot_lan user@host:~$ cd ~/Disroot/howto/vagrant
``` user@host:hubzilla-vagrant$ vagrant ssh howto_disroot_lan
```
3. Switch to root and add your host user public key. 3. Switch to root and add your host user public key.
```
vagrant@stretch:~$ sudo -i ```
root@jessie:~# ssh-keygen vagrant@stretch:~$ sudo -i
Generating public/private rsa key pair. root@jessie:~# ssh-keygen
Enter file in which to save the key (/root/.ssh/id_rsa): Generating public/private rsa key pair.
Created directory '/root/.ssh'. Enter file in which to save the key (/root/.ssh/id_rsa):
Enter passphrase (empty for no passphrase): Created directory '/root/.ssh'.
Enter same passphrase again: Enter passphrase (empty for no passphrase):
Your identification has been saved in /root/.ssh/id_rsa. Enter same passphrase again:
Your public key has been saved in /root/.ssh/id_rsa.pub. Your identification has been saved in /root/.ssh/id_rsa.
The key fingerprint is: Your public key has been saved in /root/.ssh/id_rsa.pub.
b4:e3:00:40:4f:c5:af:27:05:09:d4:70:29:ac:f8:51 root@jessie The key fingerprint is:
The key's randomart image is: b4:e3:00:40:4f:c5:af:27:05:09:d4:70:29:ac:f8:51 root@jessie
+---[RSA 2048]----+ The key's randomart image is:
| .oo=*oo | +---[RSA 2048]----+
| +E.* | | .oo=*oo |
| . oo. o. | | +E.* |
|. o . .o. | | . oo. o. |
| . . .oS | |. o . .o. |
| . oo.. | | . . .oS |
| o. | | . oo.. |
| | | o. |
| | | |
+-----------------+ | |
root@stretch:~# echo "ssh-rsa eLX1UQbJHUCHf2V3K7YlMP0YmIT+50rlEsWre1eobApKb0Ac/WbvssX/Gh/ user@host" >> ~/.ssh/authorized_keys +-----------------+
``` root@stretch:~# echo "ssh-rsa eLX1UQbJHUCHf2V3K7YlMP0YmIT+50rlEsWre1eobApKb0Ac/WbvssX/Gh/ user@host" >> ~/.ssh/authorized_keys
```
4. From your host machine, you may now SSH into the virtual machine using 4. From your host machine, you may now SSH into the virtual machine using
```
ssh root@howto.disroot.lan ```
``` ssh root@howto.disroot.lan
```