diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..6a62211 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,16 @@ +FROM registry.fedoraproject.org/fedora:26-modular +LABEL MAINTAINER "Langdon White" +ENV NAME=boltron VERSION=1 RELEASE=3 ARCH=x86_64 +# the value of com.redhat.component label is utilized as a container image name inside candidate registry +# since the container image passed the review and has a production dist-git repo, +# there should be a "boltron" component in bugzilla +LABEL com.redhat.component="boltron" \ + name="$FGC/$NAME" \ + version="$VERSION" \ + release="$RELEASE.$DISTTAG" \ + usage="docker run --rm -it f26-modular/boltron /bin/bash" \ + summary="Boltron will provide you a running and useful version of the Modular Server Preview." \ + description="For more info, please see the upstream modularity website: https://docs.pagure.org/modularity/" +COPY ./README.md /README.md +RUN microdnf install dnf +CMD ["/bin/bash"] diff --git a/README.md b/README.md new file mode 100644 index 0000000..e2f6142 --- /dev/null +++ b/README.md @@ -0,0 +1,73 @@ +Boltron Instructions +==================== + +First, please download the boltron in the /prototype/boltron/download +section. A container image is recommended if you just want to test the +user experience - as it is the easiest to run. + + $ docker run --rm -it registry.fedoraproject.org/f26/boltron /bin/bash + +Now you are ready to try Boltron! + +Managing modules with DNF +------------------------- + +You can find very similar guide on the [Walkthrough and UX +Feedback](https://goo.gl/forms/WSt2tQJHWXmhMotq2) form - and give us +feedback on the go. + +### Listing modules + +List all available modules: + + $ dnf module list + +List all installed modules: + + $ dnf module list --installed + +### Installing modules + +Modules are identified by name-stream-version. Each module might have +one or more install profiles - pre-defined sets of packages to be +installed. + +Modules can be installed by one of the following commands. + + $ dnf install + + $ dnf install - + $ dnf install -/ + + $ dnf install -- + $ dnf install --/ + +Specific examples: + + $ dnf install nginx + $ dnf install nginx-f26 + +### Updating the system + +The system can be updated the same way as a traditional Fedora. The +modules will always follow their streams. That means that if you have +nodejs 6 (nodejs-f26) installed, it will not get upgraded to nodejs 8 +(nodejs-8) even when it is available. + + $ dnf update + +### Changing streams + +If you want to change a stream of an installed module, run the same +command as if you were installing it, specifying the stream you want to +change to. + + $ dnf install nodejs-f26 + $ dnf install nodejs-8 + +### How DNF keeps track what modules are installed? + +DNF creates a .module file for each installed or enabled module. + + $ ls /etc/dnf/modules.d/ + $ cat /etc/dnf/modules.d/nodejs.module