NFS Server Sample

Identify the use cases/ user stories

• Ensure the cases are listed in the content plan
• the use cases can then be prioritized
• the use cases should be listed separately even if delivered by the same module or output artifact
• Each "project" (e.g. NFS Server) should probably have a supporting doc. For example.

Create module tests

• Each case (multiple cases may be in one repo) should point to a test-module repository (e.g. http://pkgs.stg.fedoraproject.org/cgit/test-modules/nfs-server.git/)<sup id="fnref-cheatsheet-note">1</sup>
• In the repository should be behave (or comparable) definitions for tests. For example.
• Each use case covered should have a dedicated feature file. For example.

Design and implement your module

• Ensure you have a module namespace (e.g. http://pkgs.stg.fedoraproject.org/cgit/modules/nfs-server.git)
• Create a module-md for your component. For example.
• The module-md can point to one or more rpms, nfs-utils rpm placeholders are included in this repo by way of example.

Ensure rpms used by module are tested

• Ensure you have a test-rpm namespace (e.g. http://pkgs.stg.fedoraproject.org/cgit/test-rpms/nfs-utils.git)
• Gather or develop tests for RPM either upstream or in Fedora For example.
• Ensure that your tests are being automatically run
  • Connect the triggers by following the instructions #TODO: correct link
  • Review results in resultsdb. How? #TODO: correct link

Build and test your module

• Follow the build instructions to build your module. #TODO: correct link
• Ensure that your tests are being automatically run
  • Connect the triggers by following the instructions #TODO: correct link
  • Review results in resultsdb. How? #TODO: correct link

Create container tests

• Ensure you have a test-container namespace (e.g. http://pkgs.stg.fedoraproject.org/cgit/test-containers/nfs-server.git)
• Create behave tests for your component or reuse the ones from the module. For example. #TODO tflink to indicate how to "symlink" tests
• Ensure the tests will be executable against a container. A useful framework wrapping behave is CTF.

Create container output artifact

• Ensure you have a container namespace (e.g. http://pkgs.stg.fedoraproject.org/cgit/containers/nfs-server.git)
• Create a Dockerfile (or similar) and appropriate supporting files. For example.

Build and test your container

• Follow the build instructions to build your container. #TODO: correct link
• Ensure that your tests are being automatically run
  • Connect the triggers by following the instructions #TODO: correct link
  • Review results in resultsdb. How? #TODO: correct link

Template for requesting dist-git repos

Please cut & paste the template below to author an email to threebean to request new repos.

Threebean!

Can you please create some dist-git repos for me?

- names: {name of repo, i.e. nfs-server}
- namespaces: {modules/ or docker/ ?}
- environment: {production or staging ?}

For each combination of name and namespaces:

- summary: One sentence describing this thing.
- description: A longer paragraph describing what this thing is for.