Add example RPM repo configs and associated docs

See the docs for more details.

Change-Id: Ia496d2266f84de9c34da30502b31124a45fe9fa8
Signed-off-by: Daniel Farrell <dfarrell@redhat.com>

diff --git a/packaging/rpm/README.md b/packaging/rpm/README.md
index 4491e1d60ace6b8a0c6a2e79870c012801065248..d5c8677c08742d5c4e22d3040105d6a07c1b9107 100644 (file)
--- a/packaging/rpm/README.md
+++ b/packaging/rpm/README.md
@@ -42,9 +42,10 @@ The `build.sh` script is a helper for building the RPM.
 
 The familiar RPM-related commands apply to the OpenDaylight RPM.
 
-### Installing OpenDaylight via the RPM
+### Installing OpenDaylight via a local RPM
 
-The `install.sh` script is a helper for doing the install.
+The `install.sh` script is a helper for installing OpenDaylight from a
+local RPM. It's intended for quick sanity checks after a `build.sh` run.
 
 ```
 # After you've built the RPM via build.sh, still in the Vagrant enviroment

diff --git a/packaging/rpm/example_repo_configs/README.markdown b/packaging/rpm/example_repo_configs/README.markdown
new file mode 100644 (file)
index 0000000..addd939
--- /dev/null
+++ b/packaging/rpm/example_repo_configs/README.markdown
@@ -0,0 +1,16 @@
+### Example Repository Configurations
+
+The repository configuration files in this directory provide examples
+of the configurations required for installing OpenDaylight from the CentOS
+Community Build System, where its source RPM (via `../build.sh`) is built
+in a standard environment and hosted for distribution.
+
+These repository configurations tell your package manager, like `yum`,
+the details required for installing OpenDaylight from the CBS.
+
+We will eventually use the `-testing-`, `-canidate-` and `-release-` tags to
+control the verbosity of our updates (infrequent stable releases vs frequent
+CI/CD/CR). For now, we are just using the `-canidate-` tag.
+
+We will also eventually sign our RPMs, at which point we will enable GPG
+checks via the `gpgcheck` repo config variable.

diff --git a/packaging/rpm/example_repo_configs/opendaylight-3-candidate.repo b/packaging/rpm/example_repo_configs/opendaylight-3-candidate.repo
new file mode 100644 (file)
index 0000000..946bf8f
--- /dev/null
+++ b/packaging/rpm/example_repo_configs/opendaylight-3-candidate.repo
@@ -0,0 +1,5 @@
+[opendaylight-3-candidate]
+name=CentOS CBS OpenDaylight Lithium candidate repository
+baseurl=http://cbs.centos.org/repos/nfv7-opendaylight-3-candidate/$basearch/os/
+enabled=1
+gpgcheck=0