presentations_compsoc/src/slides/skynet/1_setup.md
Brendan Golden 1d158667a5
All checks were successful
On_Push / build (push) Successful in 11s
On_Push / deploy (push) Successful in 8s
fix: repalced gitlab liks with forgejo
2024-10-06 21:08:18 +01:00

10 KiB

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ title = "Skynet: Setup" date = 2023-09-23 slides = true +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Skynet: Setup


Now that ye have the history time to get you Skynet accounts.


This is for new members.
If there are any older members please wait a little while.


New Members


  1. Be a fully paid up member of UL Computer Society

  1. Go to <https://account.skynet.ie/signup>.
    Enter the same email used for UL Wolves

  1. You will get an email to verify your address, follow the link.

  1. Choose a username and password.

Congrats! You are in! //heist music//


Returning Members


  1. Please go to <https://account.skynet.ie/modify>.
    Enter the same email used for UL Wolves

Congrats! You are in! //heist music//


Returning Members


If you have forgotten your username.
Use <https://account.skynet.ie/recover/username>


If you have forgotten your password.
Use <https://account.skynet.ie/recover/password>


All Members


Now that we are all on the same page we can now set an SSH key.


Prepwork:

cd ~/.ssh
mkdir skynet
cd skynet

ssh-keygen -t ed25519 -C "<comment>"

Location: username
Password: Press Enter twice

We will use the {username}.pub file later


Back to the ssh folder

cd ../

Windows

"" > config

Linux

touch config

Into it pop this

Host *.skynet.ie
   User %r
   IdentityFile ~/.ssh/skynet/%r
   IdentitiesOnly yes

(we will also ping this on discord)


Remember the {username}.pub in ~/.ssh/skynet ?


cat ~/.ssh/skynet/{username}.pub

Copy the text and go to <https://account.skynet.ie/modify>


Select the SSH Key field and submit.


Congratulations, you now have full access to all of Skynet's services!


Now to learn //how// to access them!


Email


  1. Go to <https://mail.skynet.ie/>
  2. Login with username@skynet.ie and password
  3. Done

Email (Thunderbird)


  1. Have Thunderbird Installed
  2. Add Account
  3. Login with username@skynet.ie and password
  4. It can take a few min.
  5. Done

Skynet Webserver


ssh {username}@skynet.skynet.ie

Thats it, you have logged into Skynet (webserver)!


Skynet Website


The server you logged onto is a webserver.


This means it can serve content on the web.


Due to aforementioned //issues// we can only serve static files (no database)


This is more than enough for most folks needs.


Create a public_html in your own home directory with correct permissions


mkdir ~/public_html 
chmod 711 ~
chmod -R 755 ~/public_html
cd ~/public_html 

Now we have a folder, time to put something in it.


nano index.html

This brings up a terminal based editor, type whatever ye want here.


To exit press [ctrl]+[x] to bring up save options.
You cna rename the file, for now just press [enter]


Go to <https://{username}.users.skynet.ie> to view your website.


That was cumbersome to do right?


Logging in.
Only to change a file on terminal that you have never used before.


Surely there is a better way?


Well luckily for you programmers are lazy


There are ways to transfer files from your local computer to the server.


Fow Windows you have WinSCP: <https://winscp.net/>


If ye are using linux you can use put sftp://{username}@skynet.skynet.ie
(or use filezilla)


Gitlab


As part of your Skynet account you have access to our Gitlab Server.


  1. Go to <https://forgejo.skynet.ie>
  2. Login with username and password
  3. Done

Gitlab Website


its possible to have a website on gitlab.


Powered by source control and CI/CD pipelines (devops)


Go to the Dashboard > Groups > New Group


Name the group Personal or College or something like that.


Inside that Group create a New Project, name it whatever ye want.


Create from Template > Any one that starts with Pages
(I recommend pages/html)


It will appear on the screen in a moment after clicking.


Go up to Edit > Web IDE > Change something on the index.html


[ctrl] + [shift] + [g] (or click the icon on the left), enter a msg
And commit to master.


Your website will now be build and deployed.


Woot!!! Devops!!!


To get teh link is a tad annoying.


Go to Settings (bottom left of repo page) > Pages


Open the link in a new tab and marvel at yer creation.


If you go back and commit new changes they will show up as well.


In a future session we will discuss Gitlab (and git in general) more.


Here completes the rough introduction to Skynet and creating websites.


If ye have any questions/ideas feel free to ask.


If ye want to take a deeper look into server admin feel free to ask.


Skynet team is always open to newcomers!