DN42 Registry
Find a file
NadeenUdantha ac40a30499 register
### DN42 Signature
### method: ssh
### mntner: NADEEN-MNT
### text: 34e98e270e70010cfe3fbb130f1f1cdbb71d0174
-----BEGIN SSH SIGNATURE-----
U1NIU0lHAAAAAQAAAZcAAAAHc3NoLXJzYQAAAAMBAAEAAAGBAMRSJzQjpp/JAoKsadkUg+
GxTSdxUhqVBGgjd2uurw284wgRz4oJgPIa89ub+lrrqeH7+lxPBpArqKnyLPnIxVKja7h/
6KhFeJ4OksUSHR+4HhYRXgXfmPhYObF9cWt3kRneTcI5PyTuU//cnmbTRslVubC/a8FCXp
6jxdJBW181lhrY/rVwYDQxaipnqKtOcm8vKsGS+mTbAW0hwQia1PKwbIRFcVyfT1Fm1yw2
k9hax5CEvojtD12tV8uPiV4q/Kipf0uLOeaFuI2/vUvut12wUAxrto+kaxkMOx6h4nyxfY
lROewWrG7f6zq58GNqEv+nJtuk4rgdxF065DLabHnMAi+Oa9MR0KtnxHsGuuY0YVzeSNeV
aMbj3Omuqor9snaLUIlyUcTYN6pwp/fCT6FumzTTz/KNjQD4c2s0sMHBwgdcyTdY4o9z9G
FqN3W3PAjr1iz/zr/Y+a1qoroLzufGZDM7wpQ7uxXLv1b11D5jVltFwzruMXfCR1bXGPXo
2wAAAARkbjQyAAAAAAAAAAZzaGE1MTIAAAGUAAAADHJzYS1zaGEyLTUxMgAAAYAiITQ552
nQJuPvR49q8kW2Eona9rMhOe0FKxa1Q3c58LEs5Zt9DKUH9Kgi+SuwjIs3vpviVG3uA4Uu
FmZDRDFXj6xGtvymhRfSEglXV9+X6o9Ce78UK0ipEZplH6DjK61sq1JHoVx4vvKFcQfK7Y
KtHd3l3xU3vKFo5X8YWvEugqHZXCSotu4v1jT5k/9C2TPI0n/JdFKJanfBCZiFxwC0SowJ
gVwINFnApq+Ge9TZ0DXcHrGqL63J6cfPEiL40TX4NPDRUwPtPg22doG4v6I4QTp5kLA6L0
Sn8x4LHMZuZU7ZDKmQJryKe+4Ii0Yq1ztieMCuvVi4i56j1kGeOPyKmsK76JU+umfOEGvS
3wMamBZlZERcUCAu7cx59VoWVoG2tytBAkXnXRW6vgCCG8eIIqclVd8NtyTwuzA51l3F15
64/7wdUs5Ix3rxGR4sgg0OQZbv3maev+xe6gh3O5ls6fYeuRWszWSbU40uCWxM7amW1sjZ
hdAcgpLxCsEiY4k=
-----END SSH SIGNATURE-----
2022-06-01 05:58:13 +00:00
data register 2022-06-01 05:58:13 +00:00
utils/schema-check
.drone.yml
.gitignore
check-my-stuff
check-pol
check-remote
fix-infrastructure-objects
fmt-my-stuff
install-commit-hook
README.md Update registry README 2022-05-27 13:10:54 +01:00
sign-my-commit
squash-my-commits

Guide for creating a Pull Request

The dn42 registry is a git repository and changes are made to it using pull requests.

There are many public guides available on how to work with remote git repositories,
e.g. git documentation or guide at github

  1. Fork the registry repo, then clone your fork to create a local working copy

Use the Fork button in the gitea UI (at the top right of the repository page), then:

git clone git@git.dn42.dev:<FOO>/registry.git

Where <FOO> is your gitea username.

  1. Make changes in your local copy

See the getting started guide in the Wiki for more information.

  • inet6num must have a random prefix to satisfy RFC4193
  • Include an auth method in your MNTNER so you changes to your objects can be authenticated
  • Run the schema checking tools to validate your changes
    • ./fmt-my-stuff MNTNER-MNT
    • ./check-my-stuff MNTNER-MNT
    • ./check-pol origin/master MNTNER-MNT
$EDITOR <change some stuff>
git add .
git commit -S
  1. Push your changes back to your forked copy of the registry
  • You must squash multiple commits together
  • You must also sign the final commit using your MNTNER authentication method.

Whilst not essential, it is also good practice to rebase your work on top of any other changes that may have happened on the master branch of the registry.

The registry contains a script that can automatically rebase and squash your commits:

./squash-my-commits -S --push

or you can do it manually:

# Add the main registry repository as another remote, you only need to do this once

git remote add dn42registry git@git.dn42.dev:dn42/registry.git

# make sure its up to date

git fetch dn42registry master

# rebase your local copy on top of the registry master
#
# -i to interactively pick the commits
# -S to sign the result with your GPG key (not required for SSH authentication)
#
# In interactive mode, make sure the first commit says 'pick'
# change the rest from 'pick' to 'squash'
# save and close to create the commit

git rebase -i -S dn42registry/master

# force push your changes back to your registry copy

git push --force

If you forget to sign your commit you can sign the existing commit using:

git commit --amend --no-edit -S
git push --force
  1. Create a pull request

In the gitea GUI, select your fork, check your changes again for a final time and then hit the 'Pull Request' button.

Your changes will go through a number of automatic checks before a final manual review by the registry maintainers. Manual reviews are typically completed once a day.

  1. Making updates

If you need to make changes to fix review issues simply make the updates to your fork and follow the process in (3) to rebase, squash and sign your changes again. You must do this for every update.

Do not close and re-open a new pull request, any changes you make on your branch will be automatically updated in the PR. Creating a new PR loses all the history and makes tracking changes harder.

  1. Tidy Up

Once your changes have been accepted and merged, you may delete your local copy and the fork that was created in gitea.

Gitea Usage

The DN42 registry is a community resource for your benefit. Registered users are free to create and use their own repositories and use the Drone CI tools, but please be considerate in your usage.

  • Repositories should be related to DN42
  • Do not create tools that make regular, automated, push changes to repositories unless agreed with the registry maintainers
  • Do not just create a mirror of other, publically available, repositories

Data Privacy

Gitea and the DN42 registry contains personal information for users who are registered in DN42; this information is stored in Canada and viewable by any registered member. In addition, anyone with access to the repository is able to make their own copies of the registry, which they may then process or transfer in arbitrary ways. You must assume that all data entered in to the registry cannot be kept private and will be made publically available.

Any personal information stored in the registry is optional and voluntarily provided by you. Whilst the registry maintainers will make best efforts to update or delete personal data, you must accept that the technical restrictions of git may make this impossible and that your information will likely have been distributed beyond the control of the registry maintainers.

If this is not acceptable for you, you must not upload your personal details to the registry.

All registered users have the capability to make copies of the registry data for their own use. If you do copy the registry you must ensure that any copies you make are deleted when no longer required and that you will make best efforts to update or delete personal data when requested.

You must not clone or mirror the registry in to a commercial git repository; commercial terms of service can be incompatible with the use of personal data in the registry.