https://github.com/katharaframework/docker-images

Dockerfiles and scripts to build Kathará Docker images.
https://github.com/katharaframework/docker-images

bird docker docker-image dockerfile frr kathara kathara-image krill openbgpd p4 quagga rift routinator rpki rpki-client ryu-controller sdn

Last synced: about 2 months ago
JSON representation

Dockerfiles and scripts to build Kathará Docker images.

• Host: GitHub
• URL: https://github.com/katharaframework/docker-images
• Owner: KatharaFramework
• License: gpl-3.0
• Created: 2019-10-14T14:12:54.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2024-02-29T15:37:00.000Z (10 months ago)
• Last Synced: 2024-05-17T00:01:37.335Z (7 months ago)
• Topics: bird, docker, docker-image, dockerfile, frr, kathara, kathara-image, krill, openbgpd, p4, quagga, rift, routinator, rpki, rpki-client, ryu-controller, sdn
• Language: Shell
• Homepage: https://www.kathara.org/
• Size: 17 MB
• Stars: 22
• Watchers: 7
• Forks: 8
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# Docker Images

This repository contains `Dockerfile`s used to build Kathará images. A list of the Docker images we provide can be found at [this page](https://hub.docker.com/u/kathara/) in the Docker Hub.

Images are built both with `docker build` and with `docker buildx` for multi-architecture support.

Currently our images are based on Debian 11 and are compiled for `amd64` and `arm64`.

If you need images based on other Linux distributions, feel free to create a PR with other Dockerfiles.

Currently available images are:

- `kathara/base`: used to build all other images. It contains a variety of network tools and some complex services like bind, apache, etc.

- `kathara/quagga`: extends the base image adding [Quagga](https://www.nongnu.org/quagga/).

- `kathara/frr`: extends the base image adding [FRRouting](https://frrouting.org/).

- `kathara/openbgpd`: extend the base image adding the [OpenBGPD daemon](https://www.openbgpd.org/).

- `kathara/krill`: extends the base image adding [Krill RPKI Certificate Authority](https://www.nlnetlabs.nl/projects/rpki/krill/).

- `kathara/routinator`: extends the base image adding [Routinator RPKI Relying Party](https://www.nlnetlabs.nl/projects/rpki/routinator/).

- `kathara/rpki-client`: extends the base image adding [OpenBGPD RPKI Client](https://www.rpki-client.org).

- `kathara/bird`: extends the base image adding [BIRD](https://bird.network.cz/).

- `kathara/rift-python`: extends the base image adding [Routing In Fat Trees (RIFT) Python Implementation](https://github.com/brunorijsman/rift-python).

- `kathara/sdn`: extends the base image adding [OpenVSwitch](https://www.openvswitch.org/) and [Ryu SDN controller](https://osrg.github.io/ryu/).

- `kathara/p4`: extends the base image adding [Behavioral Model (bmv2)](https://github.com/p4lang/behavioral-model) to compile and run P4-compliant programmable switches.

- `kathara/pox`: extends the base image adding [POX](https://github.com/noxrepo/pox) (Python based SDN Controller) and python3-networkx.

## Building from source

To build an image from source, run `make ` to build for the current architecture.

To build an image with `docker buildx` for multi-architectures use the command `make -multi`.

**Beware**: building images with `docker buildx` automatically push the images on the Kathará Docker Hub. If you are not allowed to push, change the `Makefile` before running `make`.

Example: `make quagga` or `make quagga-multi`.

## Extend Kathará Images

The easiest way to extend a Kathará image is to clone this repository, change the Dockerfile according to your needings and locally build the new image.

If you instead want to alter (locally) an existing Kathará image, refer to the following steps:

1. `docker pull kathara/`

2. `docker run -tid --name  kathara/`

3. `docker exec -ti  bash`

4. Do your thing, then exit.

5. `docker commit  kathara/`

6. `docker rm -f `