From b5e0845aab33241ee716d935425d7b029c0dd8a0 Mon Sep 17 00:00:00 2001 From: Pawel Zmarzly Date: Jan 16 2026 16:37:25 +0000 Subject: Update onboarding instructions --- diff --git a/docs/internal/building.md b/docs/internal/building.md index 8cb15bd..c005b30 100644 --- a/docs/internal/building.md +++ b/docs/internal/building.md @@ -2,17 +2,7 @@ This page is for people who want to become Hyperscale SIG members. If you want t # Becoming SIG member -Before you start, you will need a CentOS (or Fedora) account, and a Gitlab.com account. - -See [Governance doc](../policies/governance.md) for how to request your membership. - -After you are approved, you will need to click [this magic Gitlab link](https://gitlab.com/groups/centos/-/saml/sso) to link your Gitlab and CentOS accounts together. You only need to do it once. If everything went right, you will see yourself in [the member list](https://gitlab.com/groups/CentOS/Hyperscale/-/group_members). - -# Software prerequisites - -* For local test builds: `mock` and `mock-centos-sig-configs` -* To interact with the lookaside: `centos-get-sources` and `centos-lookaside-upload-sig` from `centos-packager` -* To interact with CBS: `cbs` from `centos-packager` +See [Governance doc](../policies/governance.md) for how to request your membership. Then see [Onboarding doc](./onboarding.md) for the required one-time setup. # Working with git @@ -107,6 +97,7 @@ Note that you won't be able to tag into a destination tag unless it's been regis To run a scratch build from git: ``` $ cbs build --scratch hyperscale9s-packages-main-el9s "git+https://gitlab.com/CentOS/Hyperscale/rpms/systemd.git#$(git rev-parse HEAD)" +$ cbs download-task $TASK_ID ``` To run a real build, the package needs to be registered to a destination tags first: diff --git a/docs/internal/onboarding.md b/docs/internal/onboarding.md index 90e976d..21b1475 100644 --- a/docs/internal/onboarding.md +++ b/docs/internal/onboarding.md @@ -1,30 +1,35 @@ # How to join * Read the [charter](../sig/charter.md) and think about what/why/how you'd like to work on within the SIG +* The formal membership policy is detailed on the [governance](../policies/governance.md) page, but the tl;dr is that we welcome anybody that's interested in doing work within the scope of the SIG * Join [#centos-hyperscale:fedoraproject.org](https://matrix.to/#/#centos-hyperscale:fedoraproject.org) * File an issue requesting to join (alternatively: request to join during one of the monthly meetings) -* The formal membership policy is detailed on the [governance](../policies/governance.md) page, but the tl;dr is that we welcome anybody that's interested in doing work within the scope of the SIG # Onboarding New member side: * Before joining the SIG: - * Get a Fedora account [here](https://accounts.fedoraproject.org/) if you don't have one already - * Login on [pagure.io](http://pagure.io/), [src.fedoraproject.org](https://src.fedoraproject.org) and - [git.centos.org](https://git.centos.org) to initialize your account. + * Get a Fedora account [here](https://accounts.fedoraproject.org/) if you don't have one already. + * Get a Gitlab.com account if you don't have one already. + * Login on [pagure.io](http://pagure.io/) and [src.fedoraproject.org](https://src.fedoraproject.org) to initialize your account. + * Put your GitLab and Matrix usernames in Fedora account settings at `https://accounts.fedoraproject.org/user/$YOURUSER/settings/profile/` * After joining the SIG: - * Install [mock-centos-sig-configs](https://src.fedoraproject.org/rpms/mock-centos-sig-configs) + * Link your GitLab and Fedora accounts together by clicking [this magic Gitlab link](https://gitlab.com/groups/centos/-/saml/sso). You only need to do it once. If everything went right, you will see yourself in [the member list](https://gitlab.com/groups/CentOS/Hyperscale/-/group_members). + * Install required packages: `mock`, `mock-centos-sig-configs`, `fedora-packager` and `centos-packager`. + * `mock` and `mock-centos-sig-configs` are useful for local test builds. + * `centos-get-sources` and `centos-lookaside-upload-sig` from `centos-packager` are used to interact with the lookaside. + * `cbs` from `centos-packager` is the CLI to interact with CBS (Community Build Service). It's CentOS version of `koji` from `fedora-packager`. * Set up the [packager tools](https://docs.fedoraproject.org/en-US/package-maintainers/Installing_Packager_Tools/) - * Set up your `~/.fedora.upn` to tell our tooling your FAS username if it differs from your Unix name - * Make sure to acquire a Fedora Kerberos ticket as well. More information and debugging tips can be found [here](https://fedoraproject.org/wiki/Infrastructure/Kerberos). - * Install [centos-packager](https://wiki.centos.org/Authentication#TLS_certificate) - * Run `centos-cert` to generate a new certificate - * It'll take an hour or so for the certificate to become active - * Make a calendar reminder to renew it in 6 months + * Set up your `~/.fedora.upn` to tell our tooling your FAS username if it differs from your Unix name. + * Acquire a Fedora Kerberos ticket with `fkinit -u $FAS_USERNAME`. + * More information and debugging tips can be found [here](https://fedoraproject.org/wiki/Infrastructure/Kerberos). + * Run `centos-cert -u $FAS_USERNAME` to generate a new certificate. + * You may need to wait an hour or so after being added to the right groups until a certificate can be generated. + * Make a calendar reminder to renew it every 6 months. -SIG side: +# SIG side checklist * Add the Fedora account to https://pagure.io/group/centos-sig-hyperscale -* Add the CentOS account to https://accounts.centos.org/group/sig-hyperscale -* Update the members list on https://sigs.centos.org/hyperscale/sig/membership/ +* Add the Fedora account to https://accounts.fedoraproject.org/group/sig-hyperscale +* Update [the members list](../sig/membership.md)