https://github.com/UCCNetsoc/NaC

Netsoc-as-Code - Infrastructure-as-Code for UCC Netsoc. The Ansible playbooks that power all of our backend
https://github.com/UCCNetsoc/NaC

ansible docker kvm netsoc proxmox sysadmin

Last synced: about 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/UCCNetsoc/NaC
• Owner: UCCNetsoc
• Created: 2020-02-09T00:11:53.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-04-04T10:29:22.000Z (over 1 year ago)
• Last Synced: 2024-07-27T06:40:18.905Z (about 2 months ago)
• Topics: ansible, docker, kvm, netsoc, proxmox, sysadmin
• Language: Go
• Homepage: https://netsoc.co/go/nac
• Size: 7.38 MB
• Stars: 21
• Watchers: 5
• Forks: 15
• Open Issues: 13
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


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

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

  * `ssh @control.netsoc.co -p 2222 -i `

  * 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) @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 `, i.e `./vm-ssh.sh web.infra.netsoc.co`

* The Proxmox Web UI is available at [`proxmox.netsoc.co`](https://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](https://discord.netsoc.co)

  * We'll welcome any help!

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

* Check out our [wiki](https://wiki.netsoc.co)

## **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.

### **Read [wiki.netsoc.co](wiki.netsoc.co)**