index.md

layout	venue	address	country	language	latitude	longitude	humandate	humantime	startdate	enddate	instructor	helper	email	collaborative_notes	eventbrite
lesson	LHC Physics Center, Fermi National Accelerator Laboratory	online	us	en	41.842258	-88.245781	September 1, 2023	10:00 am - 12:30 pm	2023-09-01	2023-09-01	Kevin Pedro	Clemens Lange	pedrok at fnal.gov

{% comment %} See instructions in the comments below for how to edit specific sections of this workshop template. {% endcomment %}

{% comment %} HEADER

Edit the values in the block above to be appropriate for your workshop. If the value is not 'true', 'false', 'null', or a number, please use double quotation marks around the value, unless specified otherwise. And run 'make workshop-check' before committing to make sure that changes are good. {% endcomment %}

{% comment %} Check DC curriculum {% endcomment %}

{% if site.carpentry == "dc" %} {% unless site.curriculum == "dc-ecology" or site.curriculum == "dc-genomics" or site.curriculum == "dc-socsci" or site.curriculum == "dc-geospatial" %}

It looks like you are setting up a website for a Data Carpentry curriculum but you haven't specified the curriculum type in the _config.yml file (current value in _config.yml: "{{ site.curriculum }}", possible values: dc-ecology, dc-genomics, dc-socsci, or dc-geospatial). After editing this file, you need to run make serve again to see the changes reflected.

{% endunless %} {% endif %}

{% comment %} Check SWC curriculum {% endcomment %}

{% if site.carpentry == "swc" %} {% unless site.curriculum == "swc-inflammation" or site.curriculum == "swc-gapminder" %}

It looks like you are setting up a website for a Software Carpentry curriculum but you haven't specified the curriculum type in the _config.yml file (current value in _config.yml: "{{ site.curriculum }}", possible values: swc-inflammation, or swc-gapminder). After editing this file, you need to run make serve again to see the changes reflected.

{% endunless %} {% endif %}

{% comment %} EVENTBRITE

This block includes the Eventbrite registration widget if 'eventbrite' has been set in the header. You can delete it if you are not using Eventbrite, or leave it in, since it will not be displayed if the 'eventbrite' field in the header is not set. {% endcomment %} {% if page.eventbrite %} Some adblockers block the registration window. If you do not see the registration box below, please check your adblocker settings.

<iframe src="https://www.eventbrite.com/tickets-external?eid={{page.eventbrite}}&ref=etckt" frameborder="0" width="100%" height="280px" scrolling="auto"> </iframe> {% endif %}

General Information

{% comment %} INTRODUCTION

Edit the general explanatory paragraph below if you want to change the pitch. {% endcomment %} {% if site.carpentry == "swc" %} {% include swc/intro.html %} {% elsif site.carpentry == "dc" %} {% include dc/intro.html %} {% elsif site.carpentry == "lc" %} {% include lc/intro.html %} {% endif %}

What: An opinionated introduction to using Docker and Apptainer as software development tools for use with CMSSW.

{% comment %} AUDIENCE

Explain who your audience is. (In particular, tell readers if the workshop is only open to people from a particular institution. {% endcomment %} {% if site.carpentry == "swc" %} {% include swc/who.html %} {% elsif site.carpentry == "dc" %} {% include dc/who.html %} {% elsif site.carpentry == "lc" %} {% include lc/who.html %} {% endif %}

{% comment %} LOCATION

This block displays the address and links to maps showing directions if the latitude and longitude of the workshop have been set. You can use https://itouchmap.com/latlong.html to find the lat/long of an address. {% endcomment %} {% assign begin_address = page.address | slice: 0, 4 | downcase %} {% if page.address == "online" %} {% assign online = "true_private" %} {% elsif begin_address contains "http" %} {% assign online = "true_public" %} {% else %} {% assign online = "false" %} {% endif %} {% if page.latitude and page.longitude and online == "false" %}

Where: {{page.address}}. Get directions with OpenStreetMap or Google Maps.

{% elsif online == "true_public" %}

Where: online at {{page.address}}. If you need a password or other information to access the training, the instructor will pass it on to you before the workshop.

{% elsif online == "true_private" %}

Where: This training will take place online. The instructors will provide you with the information you will need to connect to this meeting.

{% endif %}

{% comment %} DATE

This block displays the date and links to Google Calendar. {% endcomment %} {% if page.humandate %}

When: {{page.humandate}}. {% include workshop_calendar.html %}

{% endif %}

{% comment %} SPECIAL REQUIREMENTS

Modify the block below if there are any special requirements. {% endcomment %}

Requirements: Participants must bring a laptop with a Mac, Linux, or Windows operating system (not a tablet, Chromebook, etc.) that they have administrative privileges on. They should have a few specific software packages installed (listed on the setup page).

{% comment %} REFERENCES

List the sources used to put this lesson together. {% endcomment %}

References: Many of the modules were taken from the Introduction to Docker (also) tutorial and the Software containers for CMSSW tutorial.

{% comment %} ACCESSIBILITY

Modify the block below if there are any barriers to accessibility or special instructions. {% endcomment %}

Accessibility: {% if online == "false" %} We are committed to making this workshop accessible to everybody. The workshop organizers have checked that:

• The room is wheelchair / scooter accessible.
• Accessible restrooms are available.

Materials will be provided in advance of the workshop and large-print handouts are available if needed by notifying the organizers in advance. If we can help making learning easier for you (e.g. sign-language interpreters, lactation facilities) please get in touch (using contact details below) and we will attempt to provide them. {% else %} We are dedicated to providing a positive and accessible learning environment for all. Please notify the instructors in advance of the workshop if you require any accommodations or if there is anything we can do to make this workshop more accessible to you.

{% endif %}

{% comment %} CONTACT EMAIL ADDRESS

Display the contact email address set in the configuration file. {% endcomment %}

Contact: Please email {% if page.email %} {% for email in page.email %} {% if forloop.last and page.email.size > 1 %} or {% else %} {% unless forloop.first %} , {% endunless %} {% endif %} {{email}} {% endfor %} {% else %} to-be-announced {% endif %} for more information.

{% comment %} SETUP

Delete irrelevant sections from the setup instructions. Each section is inside a 'div' without any classes to make the beginning and end easier to find.

This is the other place where people frequently make mistakes, so please preview your site before committing, and make sure to run 'tools/check' as well. {% endcomment %}

{% comment %} These are the installation instructions for the tools used during the workshop. {% if site.carpentry == "swc" %} {% include swc/setup.html %} {% elsif site.carpentry == "dc" %} {% include dc/setup.html %} {% elsif site.carpentry == "lc" %} {% include lc/setup.html %} {% endif %} {% endcomment %}

Prerequisites

Follow the setup instructions on the setup page.

Have access to a computing cluster with Apptainer installed on it. We will be using the CMSLPC cluster for this demo (account request directions).

(optional) A VO registered grid certificate (request directions) setup on your local machine (setup directions)

(optional) A GitLab account (CMS users have access to CERN's GitLab instance) {: .prereq}