Skip to content

internal Quick start Guide

henri-egger edited this page Jun 20, 2022 · 6 revisions

Install OS

Install your favourite Linux Distro or other OS on your laptop.

KeePassXC

Install a Keepass Client on your machine, to store all passwords, TOTP and sensible files. Then create a new database with a good master password and you cant start to add logins and files. Note: Be careful, if you forget the master password, everything is gone for good https://keepassxc.org/

Microsoft Teams

Install the Teams Client on your machine, because it might not work so good in the browser, especially video calls. Then get an inviation for the Digital Team to be able to communicate to the whole team.

Google Account

Create a gmail account with your working account email to be able to access Google Drive docs and the Google Cloud Platform.

Element end to end encrypted chat

Go to app.element.io and get an invitation to the "NOI Developers" group from a exisitng member of the group to chat with the other developers on an e2e encrypted chat system. Here it's safe to share sensible data like passwords or files with sensible content.

Jenkins

Jenkins us used for the continous integration of the projects. Here you can see all automated build processes and if error console logs if a build fails. Login with your Microsoft Account at the following sites:

  1. https://jenkins.testingmachine.eu
  2. https://ci.opendatahub.bz.it

Note: If the loading doesn't stop check if the IP address is whitelisted. If it still doesn't stop loading, check that you have https:// and not http:// in the URL.

Github Actions

Jenkins will be replaced with Github Actions by the end of 2022. So if you create new CI/CD pipelines, create them with Github Actions.

SSH

Generate a public and private SSH key, if you don't have one already. Add it to you github account at https://github.com/settings/keys You can then use this key also to connect directly. Note: Ask a NOI developer for the .ssh/config file, to get easier access to the existing servers. So you can just write ssh server_name to access it.

AWS

  1. Get access to https://console.aws.amazon.com from an existing developer account
  2. Setup Multi-factor authentication in https://console.aws.amazon.com/iam/home?#/security_credentials
  3. Check out the services in use to get a quick overview: S3, EC2, RDS, Elastic Beanstalk, Route53.

Request Tracker account for issues.opendatahub.bz.it

Get an account to be able to see, assign and solve issues for the Open Data Hub.

Grafana

Here you can find all dashboards showing realtime diagrams about projects like the Open Data Hub. https://grafana.testingmachine.eu/login

Github Projects Kanban

Here you can find all Kanban diagrams to the current running projects.
https://github.com/orgs/noi-techpark/projects/1
A bi weekly sprint meeting defines the issues you will be working on.

Keycloak

Create a Keycloak account in the Master page with a registered keycloack account and then login at https://auth.opendatahub.bz.it/auth/

Docker and docker-compose

Install docker for your machine, if you work with Windows you may need to install a WSL 2 backend first. Documentation for this process is provided at: https://docs.docker.com/get-docker/

Clone this wiki locally