OSM15 Hackfest

2023-06-30T08:19:41Z

Borsatti: Added challenges presentation

[[File:OSM15_Banner.png|800px|center|top]]

[[File:OSM15_Hack.png|300px|right|top|link=https://portal.etsi.org/Meetings.aspx#/meeting?MtgId=45715]]
= Overview =
ETSI's Centre for Testing and Interoperability and the OpenSourceMANO community are organizing the '''OSM#15 Hackfest''' on '''12-16 June 2023'''. The event will be hosted by '''[https://www.cttc.cat/ CTTC]''' and co-located with the '''[https://portal.etsi.org/Meetings.aspx#/meeting?MtgId=45641 OSM#15 Plenary Meeting]'''.

On Wednesday, 14 June, Hackfest and Plenary participants will meet at the '''[https://osm.etsi.org/wikipub/index.php/OSM15_Ecosystem_Day OSM#15 Ecosystem Day] '''.

Participation in ETSI Hackfests is free and open to all upon '''[https://portal.etsi.org/Meetings.aspx#/meeting?MtgId=45715 registration]'''.

= Venue =
CTTC
Parc Mediterrani de la Tecnologia (PMT) - Building B6 - Auditorium (Level 0)
Av. Carl Friedrich Gauss 7
08860 - Castelldefels
Barcelona, Spain

* [[Media:hotels_Castelldefels.pdf|Hotels]]
* [https://www.cttc.cat/contact/ Directions]
* [https://www.barcelonaturisme.com Local information]
* VISA: Should you require a personal invitation letter for your visa application, please fill in this [[media:OSM15_VISA_Letter.docx | template]] and send it to Ricard Vilalta ricard.vilalta ''_at_'' cttc.es

= Scope =
This event is a development-oriented Hackfest in the form of several self-contained challenges such as bug fixes, developing small features, writing unit tests, or automating end-to-end tests exercising some use case. Key members of the OSM community will mentor challenges.

The Hackfest will start on Monday, 12 June, and finish on Friday, 16 June. On Monday, some theory sessions will be provided, followed by a description of the different challenges to be completed throughout the week. Participants will select a challenge to work on individually or in pairs.

During the week, participants will code autonomously (individually or in pairs) to solve their challenges. Daily sessions will be scheduled with the mentors so that participants can ask questions and solve blocking points.

On Friday, participants will share their achievements and lessons learned with the OSM community.

All active participants will receive a Certificate of Participation. Certificates of Excellence will be awarded to all those participants that complete their challenge.

This event will be an opportunity for participants:
* Understanding the role of NFV Orchestration and OSM
* Understanding OSM architecture and relationship with ETSI NFV Specifications
* Getting familiar with OSM installation
* Understanding OSM development workflow, practices, and tools: Git, Tox, Gerrit, Jenkins...
* Understanding how to work in an open source project: contributing code, code reviews, automated testing...
* Developing a first-hand experience with code development in OSM
* Getting to meet and interact with crucial OSM community members.

= Who should attend =
* This Hackfest is dedicated to software developers willing to gain first-hand experience contributing to Open Source MANO (ETSI OSM).

[[File:OSM_community_barcelona.jpg|800px|center]]

= Week Plan =
<iframe key="teamup" path="ks785k7novpbigqwxv?date=2023-06-12&showProfileAndInfo=0&showSidepanel=1&showAgendaHeader=1&showAgendaDetails=0&showYearViewHeader=1" width="90%"/>

[https://teamup.com/ks785k7novpbigqwxv See details]

== Theory Sessions ==
The Hackfest will start on Monday morning 10 am with some theory sessions and presentation of the challenges. Local registration will open at 9 am.
* P1 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P1%20Welcome%20and%20Logistics%20for%20the%20Week.pdf Host Welcome and Logistics for OSM#15] by Pol Alemany, CTTC
* P2 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P2%20Intro%20to%20the%20Hackfest%20for%20OSM%20developers.pdf Introduction to the Hackfest] by Gerardo Garcia, Telefonica
* P3 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P3%20Introduction%20to%20OSM.pdf Introduction to OSM] by Gerardo Garcia, Telefonica
* P4 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P4%20OSM%20Architecture.pdf OSM Architecture] by Guillermo Calvino (Canonical)
* P5 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P5%20OSM%20installation.pdf OSM Installation Demo] by Gerardo Garcia, Telefonica
* P6 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P6%20OSM%20Usage.%20Onboarding.pdf OSM Usage. Onboarding] by Gulsum Atici (Canonical)
* P7 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P7%20OSM%20Usage.%20Instantiation%20and%20Operation.pdf OSM Usage. Instantiation and Operation] by Mark Beierl (Canonical)
Lunch Break
* P8 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P8%20Hackfest%20environment.pdf Hackfest environment] by Chiara Grasselli (Unibo)
* P9 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P9%20How%20to%20develop%20for%20osmclient.pdf How to Develop for OSM Client] by Pedro Escaleira (IT)
* P10 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P10%20How%20to%20contribute%20to%20OSM.pdf How to Contribute to OSM] by Gulsum Atici (Canonical)
* P11 [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315%20Hackfest%20P11%20Hackfest%20challenges.pdf Presentation of Challenges]
* Q&A
* Challenges Distribution

== Hacking Sessions ==
Participants will spend most of the week working autonomously on their challenges, with the support of some OSM community members.

== Meeting with Mentors ==
Several times a day, participants will get the chance to meet with their mentors in order to discuss progress and overcome blocking points.

== Ecosystem Day ==
On Wednesday afternoon, the OSM Community will meet for the OSM Ecosystem Day, a workshop allowing organizations in the [https://osm.etsi.org/wikipub/index.php/OSM_Ecosystem OSM Ecosystem] to share about their Open Source MANO experience and how OSM is helping them to achieve their goals. [https://osm.etsi.org/wikipub/index.php/OSM15_Ecosystem_Day#Agenda See agenda.]



== Demos & Wrap Up ==
On Friday morning, after a last hacking session, participants to the challenges will share their achievements and lessons learnt with the OSM community. The Hackfest will finish at 1pm.
* [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315_Hackfest_Results_Challenge_1_CARLOS_HERNANDEZ_CHULDE.pdf Challenge 1 - Carlos Hernandez-Chulde]
* [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315_Hackfest_Results_Challenge_2_Daniel_Adanza_Dopazo.pdf Challenge 2 - Daniel Adanza Dopazo]
* [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315_Hackfest_Results_Challenge_5_Patricia_Reinoso.pdf Challenge 5 - Patricia Reinoso]
* [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/OSM%2315_Hackfest_Results_Challenge_7_Dario_Faccin.pdf Challenge 7 - Dario Faccin]

== Hackfest Material ==
* [https://osm-download.etsi.org/ftp/Hackfests/OSM15_Hackfest/ Hackfest Presentations]
* [https://osm-download.etsi.org/ftp/Ecosystem_Days/OSM15_Ecosystem_Day/ Ecosystem Day Presentations]

= How to get ready =
== Prerequisites ==
* '''[https://portal.etsi.org/Meetings.aspx#/meeting?MtgId=45715 Registration]''' is mandatory!
* Participants will need an '''[https://portal.etsi.org/CreateAccount#/home ETSI Online Account]''' (if they work for an '''[https://portal.etsi.org/TB-SiteMap/OSM/List-of-OSM-Members OSM Member or Participant]''') or an '''[https://osm.etsi.org/register Individual Contributor Account]''' to '''[https://osm.etsi.org/gerrit contribute code in Gerrit]''' or to '''[https://osm.etsi.org/bugzilla file bug reports]'''.
* Participants are expected to have previous knowledge of '''Python'''.
** Experience with '''Git''', '''Docker''', '''Linux''', '''Kubernetes''', '''Openstack''', and the '''Robot Framework''' for testing, will be a plus.
* Participants will need ''' their laptop''' to develop, and a '''remote lab''' environment will be provided for testing. There are several options:
** Recommended: '''Ubuntu 22.04'''
** Other options:
*** Windows10 or higher
*** Other Linux OS, as long as they can meet the requirements below in terms of SW installation.
* Optionally, if they want to install OSM in their laptop, the only recommended setup is a computer with '''Ubuntu 22.04''' and the following HW requirements:
** 4 CPUs;
** 12 GB of RAM;
** 120 GB of disk free space.

== Prepare your environment for the Hackfest ==

=== Preparation for Linux Ubuntu 22.04 ===
<pre>
# Install Python 3.10
$ sudo apt-get update
$ sudo apt-get install python3 python3-pip python3-dev
$ python3 --version # Python 3.10.X expected as output
$ sudo apt-get install git

# Install VSCode (https://code.visualstudio.com/docs/setup/linux)
$ sudo apt-get install wget gpg
$ wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
$ sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg
$ sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
$ rm -f packages.microsoft.gpg
$ sudo apt install apt-transport-https
$ sudo apt update
$ sudo apt install code # or code-insiders

# Install Docker (https://docs.docker.com/engine/install/ubuntu/ and https://docs.docker.com/engine/install/linux-postinstall/)
$ sudo apt-get update
$ sudo apt-get install ca-certificates curl gnupg
$ sudo install -m 0755 -d /etc/apt/keyrings
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
$ sudo chmod a+r /etc/apt/keyrings/docker.gpg
$ echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
$ sudo groupadd docker
$ sudo usermod -aG docker $USER
$ newgrp docker

##############################################################################################################################
# In some challenges, you may also need Openstack CLI and kubectl
## For Openstack CLI (https://docs.openstack.org/newton/user-guide/common/cli-install-openstack-command-line-clients.html)
$ sudo apt install python-dev python-pip
$ pip install python-openstackclient
## For kubectl (https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/)
$ sudo apt-get update
$ sudo apt-get install -y ca-certificates curl
$ sudo curl -fsSLo /etc/apt/keyrings/kubernetes-archive-keyring.gpg https://packages.cloud.google.com/apt/doc/apt-key.gpg; echo "deb [signed-by=/etc/apt/keyrings/kubernetes-archive-keyring.gpg] https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list'
$ echo "deb [signed-by=/etc/apt/keyrings/kubernetes-archive-keyring.gpg] https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list
$ sudo apt-get update
$ sudo apt-get install -y kubectl
</pre>

=== Preparation for Windows ===
* '''[https://code.visualstudio.com/ VSCode]''' or other IDE with Python support.
* '''[https://www.python.org/downloads/release/python-3100/ Python 3.10]'''.
* '''[https://git-scm.com/ Git]'''.
* Program to access remote machines via SSH. Participants can now use SSH from PowerShell. Other alternatives are '''[https://www.putty.org/ Putty]''' or '''[https://mobaxterm.mobatek.net/ Mobaxterm]'''.
* Participants can also set up '''[https://learn.microsoft.com/en-us/windows/wsl/install Windows Subsystem for Linux (WSL)]'''.
* '''[https://docs.docker.com/desktop/install/windows-install/ Docker]''' (participants can set up Docker using WSL or Hyper-V and Windows containers, although the first is preferred).

= Previous Hackfests =
* [[OSM-MR13 Hackfest | OSM-MR#13 Hackfest - Amsterdam (NL)]]
* [[OSM13 Hackfest | OSM#13 Hackfest - Remote]]
* [[OSM12 Hackfest | OSM#12 Hackfest - Remote]]
* [[OSM-MR11 Hackfest | OSM-MR#11 Hackfest - Remote]]
* [[OSM11 Hackfest | OSM#11 Hackfest - Remote]]
* [[OSM-MR10 Hackfest | OSM-MR#10 Hackfest - Remote]]
* [[OSM10 Hackfest | OSM#10 Hackfest - Remote]]
* [[OSM-MR9 Hackfest | OSM-MR#9 Hackfest - Remote]]
* [[OSM9 Hackfest | OSM#9 Hackfest - Remote]]
* [[OSM-MR8 Hackfest | OSM-MR#8 Hackfest - Remote]]
* [[8th OSM Hackfest | 8th OSM Hackfest - Lucca (Italy)]]
* [[7th OSM Hackfest | 7th OSM Hackfest - Patras (Greece)]]
* [[6th OSM Hackfest | 6th OSM Hackfest - Santa Clara (CA, USA)]]
* [[5th OSM Hackfest | 5th OSM Hackfest - Barcelona (Spain)]]
* [[4th OSM Hackfest | 4th OSM Hackfest - Palo Alto (CA, USA)]]
* [[3rd OSM Hackfest | 3rd OSM Hackfest - Oslo (Norway)]]
* [[2nd OSM Hackfest | 2nd OSM Hackfest - Madrid (Spain)]]
* [[1st OSM Hackfest | 1st OSM Hackfest - Sophia Antipolis (France)]]

= Get involved in OpenSourceMANO =
* Join the [https://join.slack.com/t/opensourcemano/shared_invite/zt-1688p662q-2ZUJghK_XeCJsoZWLh_KPA OSM Community Slack Workspace]
* If your organization is already an [https://portal.etsi.org/TBSiteMap/OSM/ListofOSMMembers.aspx OSM member], you can also:
** [https://webapp.etsi.org/createaccount/ Request an EOL account] (if you don’t have one yet)
** Subscribe [https://list.etsi.org/scripts/wa.exe?SUBED1=OSG_OSM&A=1 OSG OSM] and [https://list.etsi.org/scripts/wa.exe?SUBED1=OSM_TECH&A=1 OSM TECH] mailing lists
* If your organization is not yet an OSM member:
** Learn [https://osm.etsi.org/about/how-to-join how to join], it is free and open to all
* Join the [https://osm.etsi.org/wikipub/index.php/OSM_Ecosystem OSM Ecosystem]

= Contact =
Please send your technical questions to [mailto:OSM_TECH@list.etsi.org OSM_TECH@list.etsi.org] or join the [https://join.slack.com/t/opensourcemano/shared_invite/zt-1688p662q-2ZUJghK_XeCJsoZWLh_KPA OSM Community Slack Workspace]

Questions about ETSI, joining OSM, this Hackfest, and future events can be sent to: [mailto:OSMSupport@etsi.org OSMSupport@etsi.org]

OSM Public Wiki - User contributions [en]

OSM15 Hackfest