Skip to content
/ NaC Public

Netsoc-as-Code - Infrastructure-as-Code for UCC Netsoc. The Ansible playbooks that power all of our backend

Notifications You must be signed in to change notification settings

UCCNetsoc/NaC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

I'm a new SysAdmin, what the heck do I do?

  • ssh into the Ansible control server (currently control.netsoc.co:2222)

    • ssh <username>@control.netsoc.co -p 2222 -i <path to ssh key>
    • If you have not supplied an SSH key to the Head SysAdmin already:
      • Open a PR adding your username and key to setup-control-host.yml
  • Clone this repo

  • Run ./start-dev.sh inside the cloned folder (or ./start-dev.sh fish to use fish instead of bash)

    • You will need to run ./start-dev.sh to setup the correct Python packages and environment variables. You must do this before beginning any development/deployment
    • You will be able to tell you have done this when your terminal prompt looks like this:
      • (NaC) <user>@feynman:~/NaC#
  • You will need a keys/ folder which contains SSH keys to target all physical and virtual machines. Ask the Head SysAdmin for this.

    • Do NOT commit them or remove the keys/ clause from .gitignore.
    • Do NOT share them with people who are not SysAdmins
    • Do NOT leave them sitting on a random server somewhere
  • You can peek and edit the vault using ./vault-peek.sh and ./vault-edit.sh

  • You can list *.vm.netsoc.co by using ./vm-list.sh

  • You can ssh into *.vm.netsoc.co by running ./vm-ssh.sh <hostname>, i.e ./vm-ssh.sh web.infra.netsoc.co

  • The Proxmox Web UI is available at proxmox.netsoc.co. You may need to type thisisunsafe (if using Chrome) to get past the SSL warning

  • For your development, you can use sshfs / VSCode Remote / vim on the control server / a git branch.

    • You will need to run your playbooks on the control server

I want to contribute but I'm not a SysAdmin?

  • Consider making an issue or contact us in #servers in our Discord
    • We'll welcome any help!

I like this repo and want to learn more about UCC Netsoc

  • Check out our wiki

Important

This repo currently contains both playbooks for managing 2019/2020 bare-metal infra and 2020/2021 Proxmox infra. Do not get them confused, have a look at ./hosts to see what's going on.