Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rdkcentral/BundleGen
A command-line tool to convert OCI Images into extended OCI Bundles for use with the Dobby container manager.
https://github.com/rdkcentral/BundleGen
Last synced: 3 months ago
JSON representation
A command-line tool to convert OCI Images into extended OCI Bundles for use with the Dobby container manager.
- Host: GitHub
- URL: https://github.com/rdkcentral/BundleGen
- Owner: rdkcentral
- License: apache-2.0
- Created: 2020-09-07T10:47:38.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-12-04T07:49:56.000Z (12 months ago)
- Last Synced: 2024-04-27T19:32:49.804Z (7 months ago)
- Language: Python
- Size: 3.88 MB
- Stars: 5
- Watchers: 6
- Forks: 32
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: COPYING
Awesome Lists containing this project
README
# OCI Bundle Generator (BundleGen)
RDK Component to generate extended OCI bundle*'s from OCI Images, ready to be run by Dobby
## Environment Setup
You will need Python >=3.7 installed and configured. You will also require some project specific dependencies and OCI tools.
A Fedora 32 `Vagrantfile` is included to provide a ready-to-use environment. Otherwise follow the steps later in this document to set up your own Fedora/Ubuntu environment.
## Quick Start
Start the Vagrant VM and SSH in.
```console
vagrant up
vagrant ssh
```
Activate the Python venv
```console
cd ~/bundlegen
source .venv/bin/activate
```
Run BundleGen:
If using an image generated by the DAC SDK, then run
```console
bundlegen generate --platform
```
If using an image from a generic OCI registry (not built by the DAC SDK), then run
```console
bundlegen generate --platform --appmetadata
```
Note the image URL should be in the form `docker://image-url`. If the image is on the Docker Hub, the full URL can be omitted - e.g `docker://hello-world`.
See the `docs` directory for more detailed documentation.
### Docker
A dockerfile is included that can be used to run BundleGen as an alternative to Vagrant. See the `docker` directory for instructions on how to use.
## Test Scripts
Test scripts are included for reference platforms to speed up the generation and installation process.
Install and test already generated bundle:
```
./test/testapp.sh 192.168.1.124 rpi-dac-image-wayland-egl-test.tar.gz
```
Generate bundle for Raspberry Pi
```
./test/build_and_test_on_rpi.sh 192.168.1.124 dac-image-wayland-egl-test.tar
```
## Development
*These steps only apply if you're not using the included Vagrantfile*
For development, you will need Python >=3.7 installed and configured. Once installed, then install project specific dependencies.
### Fedora 32
It's easier to work in Fedora as the OCI tooling is already available
```bash
# Install dependencies
sudo dnf upgrade -y
sudo dnf install -y make git skopeo go go-md2man
# Install Go
mkdir -p $HOME/go
echo 'export GOPATH=$HOME/go' >> $HOME/.bashrc
source $HOME/.bashrc
# Build/install umoci
go get -d github.com/opencontainers/umoci
cd $GOPATH/src/github.com/opencontainers/umoci/
make
sudo make install
# Setup virtual envioment
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install --editable .
```
### Ubuntu >=18.04
It's also possible to build on Ubuntu.
Note Skopeo only publishes packages for Ubuntu 18.04 or newer. It may be possible to build skopeo from source on older distributions, see https://github.com/containers/skopeo/blob/master/install.md
```bash
# Install dependencies
sudo apt update
sudo apt upgrade
sudo apt install -y make git go-md2man
# Install Go 1.13
wget https://dl.google.com/go/go1.13.12.linux-amd64.tar.gz
tar -xvf go1.13.12.linux-amd64.tar.gz
sudo mv go /usr/local
mkdir -p $HOME/go
echo 'export GOPATH=$HOME/go' >> $HOME/.bashrc
echo 'export GOROOT=/usr/local/go' >> $HOME/.bashrc
echo 'export PATH=$GOPATH/bin:$GOROOT/bin:$PATH' >> $HOME/.bashrc
source $HOME/.bashrc
# Build/install umoci
go get -d github.com/opencontainers/umoci
cd $GOPATH/src/github.com/opencontainers/umoci/
make
sudo make install
# Install skopeo
. /etc/os-release
sudo sh -c "echo 'deb http://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/x${NAME}_${VERSION_ID}/ /' > /etc/apt/sources.list.d/devel:kubic:libcontainers:stable.list"
wget -nv https://download.opensuse.org/repositories/devel:kubic:libcontainers:stable/x${NAME}_${VERSION_ID}/Release.key -O- | sudo apt-key add -
sudo apt update && sudo apt install skopeo
# Setup virtual envioment
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install --editable .
```
---
# Copyright and license
If not stated otherwise in this file or this component's LICENSE file the following copyright and licenses apply:
Copyright 2020 Consult Red
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.