DLS RHEL7 in a Box Developer Container

A Diamond Light Source specific developer container.

This repo defines a container and launch script for re-creating the DLS Controls RHEL7 developer environment on a RHEL8 Workstation.

Source code	https://github.com/dls-controls/dev-c7
Documentation	https://dls-controls.github.io/dev-c7
Releases	https://github.com/dls-controls/dev-c7/releases
Images	https://ghcr.io/dls-controls/dev-c7

Quick Start

See the tutorial at Quick Start.

How the documentation is structured

Documentation is split into four categories, also accessible from links in the side-bar.

Tutorials

Tutorials for installation, library and commandline usage. New users start here.

Tutorials

• Quick Start
  • Setup
  • Update for August 2024
  • Startup Script “c7”
  • How to Work
  • Install edm fonts
• More Features
  • Options
  • Versions
  • Lifetime
  • Deleting the container
  • Upgrade to a new c7 launcher version
• VSCode Integration
  • Initial Setup
    • Install remote development plugin
    • Update VSCode User settings
  • How to Use
  • Container Lifetime
  • VSCode Container Removal
  • Known Issues
    • First integrated terminal
• Bash Prompt in dev-c7
  • Modify .bashrc_local
  • Change the hostname

How-to Guides

Practical step-by-step guides for the more experienced user.

How-to Guides

• Managing Containers and Images on a Workstation
  • Definitions
  • Monitoring
  • Cleaning Up Space
• Defining a Container Image
• Troubleshooting
  • EDM Fonts
  • Insufficient UIDs/GIDs
  • subuid settings missing
  • PyQt Errors
  • Memory Protections Error
• Derive your own container image
• Updating Podman Settings
  • Features

Explanations

Explanation of how the library works and why it works that way.

Explanations

• How the dev-c7 Container Works
  • Podman
  • Containers
  • Container lifetime
  • File Systems
  • User Profile
• RHEL7 native vs dev-c7
  • Centos vs RHEL7
  • User IDs
  • No Services
• Purpose of the dev-c7 Container

Reference

Practical step-by-step guides for the more experienced user.

Reference

• Contributing
  • Testing
    • Adding Features to the Container Image
    • Make Container Image
  • Documentation
  • Release Process
• Releases

About the documentation

Why is the documentation structured this way?