[PROJECT ONBOARDING] kgateway

[mrbobbytables]

trafficstars

Welcome to CNCF Project Onboarding

Sandbox Application reference issue: https://github.com/cncf/sandbox/issues/319

This is an issue created to help onboard your project into the CNCF after the TOC has voted to accept your project.

We would like your project to complete onboarding within one month of acceptance.

Please track your progress by using "Quote reply" to create your own copy of this checklist in an issue, so that you can update the status as you finish items.

REQUIRED BEFORE PROCEEDING WITH ONBOARDING

A "Project Contribution Agreement" must be completed and any existing trademarks MUST be transferred to the Linux Foundation BEFORE CNCF staff onboarding tasks can be completed. Other tasks can be done by projects in the meantime.

• [x] Review and understand the CNCF IP Policy. Ensure you are using a CNCF compatible license; inbound projects must use the Apache 2.0 license or seek approval for exceptions. Licenses for dependencies are covered separately below.
• [x] Review and understand the LF trademark guidelines. Let the TOC know if you plan to change your project name.
• [ ] Transfer any trademark and logo assets to the Linux Foundation via the Contribution Agreement. CNCF staff will send this document to the contact emails listed in the Sandbox application.

---

Review and understand other documents

• [x] The Technical Leadership Principles that outlines the expected behavior for any maintainer in a leadership role.
• [x] The project proposal process and requirements.
• [x] The services available for your project at the CNCF.
• [x] The dependency license allowlist.
• [x] The online program guidelines.
• [x] The telemetry data collection and usage policy.
• [x] Optional: Book time with CNCF staff to understand project benefits and event resources.

Contribute and transfer other materials

• [x] Move your project to its own separate neutral GitHub organization. This will make it transferable to the CNCF's GitHub Enterprise account. If it's already in a GHE account, you will need to remove it from that first.
• [x] Accept the invite to join the CNCF GitHub Enterprise account. We'll then add thelinuxfoundation as an organization owner to ensure neutral hosting of your project.
• [x] Migrate your Slack channels (if any) to the Kubernetes or CNCF Slack workspace. CNCF staff can help.
• [x] Join the #maintainers-circle Slack channel.
• [ ] Transfer your domain to the CNCF. The "LF Stakeholder email" is [email protected]. The "Project" is CNCF.
• [x] Submit a pull request with your artwork.
• [ ] Transfer website analytics to [email protected]. CNCF staff can help.

Update and document project details

• [ ] Ensure that DCO (preferred) or CLA are enabled for all GitHub repositories of the project.
• [x] Ensure that that the CNCF Code of Conduct (or your adopted version of it) are explicitly referenced at the project's README.md on GitHub.
• [ ] Ensure LF footer is on your website and guidelines are followed (if your project doesn't have a dedicated website, please adopt those guidelines for the README.md file). The project-specific footer text you should use will be provided in the Contribution Agreement instructions.
• [ ] Create a maintainer list and add it to the aggregated CNCF maintainer list via pull request.
• [ ] Provide emails for the maintainers to get access to the maintainers mailing list and Service Desk. Email them to [email protected].
• [x] Start working on written, open governance and consider adding this to a GOVERNANCE.md file at the root of your repo.
• [ ] Start on an OpenSSF Best Practices Badge.

CNCF staff tasks to support the project

• [x] Add the project to DevStats.
• [x] Add the project to CLOmonitor.
• [x] Add the project to LFX Insights. This is done by adding a read-only app to your GitHub organization once it's in CNCF GHE.
• [x] Add the project to LFX Project Control Center.
• [ ] Add the project to the Cloud Native Landscape by updating landscape.yml following these instructions.
• [ ] Add a license scanning tool, like FOSSA or Snyk.
• [ ] Send a welcome email to confirm maintainer list access.

[krook]

Welcome to the CNCF Sandbox!

We’re preparing your Contribution Agreement (CA) and will email it to the contacts on your Sandbox application soon. Here’s a preview of a generic CA, which sets up a legal entity for the project and assigns trademarks and logos to the Linux Foundation.

In the meantime, you can tackle some onboarding tasks that don’t depend on the CA, like reviewing documents, outlining any existing governance, and preparing your maintainer lists.

[craigbox]

Can you please help us get us set up with a 1-3 user Google Workspace instance for kgateway.dev? Or should we set this up ourselves and set billing to CNCF?

[lukaszgryglicki]

DevStats instance added.

[lukaszgryglicki]

Project added to All CNCF DevStats instance and also to Projects Health dashboard.

[linsun]

Regarding Transfer [your domain to the CNCF](https://jira.linuxfoundation.org/plugins/servlet/desk/portal/2/create/63?requestGroup=19). The "LF Stakeholder email" is [[email protected]](mailto:[email protected]). The "Project" is CNCF., per @yuval-k, our kgateway.dev domain, which is part of a bundle can't be transferred within 120 days of the bundle purchase date. We'll start the transfer after March 21, 2025.

[cynthia-sg]

Project has been added to CLOMonitor

[krook]

Now that your project is in the CNCF GitHub Enterprise account we're going to do these two tasks on our side:

• Add thelinuxfoundation as an an organization owner, if it's not already one.
• Use that id to install the "LFX CM" GitHub app which will feed read-only, public activity to LFX Insights.

[krook]

@linsun the Contribution Agreement draft has just been sent by email to the folks listed on the Sandbox application for review. Please let us know if there are any changes (like contact info and additional trademarks) that should be included.

[linsun]

Tried to submit artwork based on what we currently have: https://github.com/cncf/artwork/pull/549

[krook]

• Add thelinuxfoundation as an an organization owner, if it's not already one.
• Use that id to install the "LFX CM" GitHub app which will feed read-only, public activity to LFX Insights.

This has now been done by CNCF staff.

[jenshu]

These are done:

Ensure that DCO (preferred) or CLA are enabled for all GitHub repositories of the project.

Provide emails for the maintainers to get access to the maintainers mailing list and Service Desk. Email them to [email protected].

[riaankleinhans]

Mailing list created and welcome email sent. https://lists.cncf.io/g/cncf-kgateway-maintainers/messages

[RobertKielty]

@linsun I created a kgateway team on FOSSA and I sent out invitaions successfully to all registered maintainers.

Let me know when one the team has accepted an invitation.

I must then add that team member to the team as a Team Admin. Then, and only then, can you start importing project repos for license scanning.

[RobertKielty]

@Rachael-Graham @jahvon and @jbohanon thank you for accepting your invitations to join CNCF FOSSA.

I have added you as Team Admins to the kgateway team.

http://app.fossa.com/account/settings/organization/teams/85747

Follow the setup guides to import code repos into CNCF FOSSA.

https://docs.fossa.com/docs/quick-import

I resent expired invitations to

@artberger @ashleywang1 @craigbox @danehans @EItanya @ilrudie @jenshu @kdorosh @lgadban @linsun @Nadine2016 @nfuden @npolshakova @saiskee @sam-heilbron @ilackarms @sheidkamp @shashankram @stevenctl @timflannagan @tjons @wendeh @williamgrh @yuval-k

The invitations are valid for the next 48hrs.

Please accept the invitations.

Then I or @Rachael-Graham @jahvon and @jbohanon (as Team Admins) can add you to the above team by clicking on Add Users on the team page.

[linsun]

Thank you @riaankleinhans and @RobertKielty - I've accepted the invitation. The ping in github is very helpful!

[linsun]

Regarding Transfer [your domain to the CNCF](https://jira.linuxfoundation.org/plugins/servlet/desk/portal/2/create/63?requestGroup=19). The "LF Stakeholder email" is [[email protected]](mailto:[email protected]). The "Project" is CNCF., per @yuval-k, our kgateway.dev domain, which is part of a bundle can't be transferred within 120 days of the bundle purchase date. We'll start the transfer after March 21, 2025.

Pinged @yuvak-k today offline to get started on this.

[linsun]

Hi @krook and team, I'm happy to get started to work on this, if this hasn't been done yet. Please advise what I need to do, thanks!

[ ] Transfer website analytics to [email protected]. CNCF staff can help.

[krook]

Thank you @linsun. That's generally a matter of inviting that email address as an admin of your Google Analytics, or other, account, if you have analytics. FYI @chalin

And on this one, you can add it to the footer of kgateway.dev even before the domain is transfered:

Copyright © kgateway a Series of LF Projects, LLC For website terms of use, trademark policy and other project policies please see lfprojects.org/policies/.

[linsun]

Hi @krook I think we can check off this box as well, do let me know if you disagree.

[ ] Ensure LF footer is on your website and guidelines are followed (if your project doesn't have a dedicated website, please adopt those guidelines for the README.md file). The project-specific footer text you should use will be provided in the Contribution Agreement instructions.

Attaching footer of the website: kgateway.dev:

[krook]

Thanks @linsun, looks like our comments were posted at the same time. For the footer, check out my comment above.

[linsun]

Thank you @linsun. That's generally a matter of inviting that email address as an admin of your Google Analytics, or other, account, if you have analytics. FYI @chalin

Our analytics person is currently out on paternity leave, it is not clear if I have permission to. I'll ping him when he is back to office.

[linsun]

Thank you @linsun. That's generally a matter of inviting that email address as an admin of your Google Analytics, or other, account, if you have analytics. FYI @chalin

And on this one, you can add it to the footer of kgateway.dev even before the domain is transfered:

Copyright © kgateway a Series of LF Projects, LLC For website terms of use, trademark policy and other project policies please see lfprojects.org/policies/.

Will do and post an updated when it is done!

[craigbox]

Copyright © kgateway a Series of LF Projects, LLC For website terms of use, trademark policy and other project policies please see lfprojects.org/policies/.

Will do and post an updated when it is done!

https://github.com/kgateway-dev/kgateway.dev/pull/189

[RobertKielty]

@artberger @ashleywang1 @craigbox @danehans @EItanya @ilrudie @jenshu @kdorosh @lgadban @linsun @Nadine2016 @nfuden @npolshakova @saiskee @sam-heilbron @ilackarms @sheidkamp @shashankram @stevenctl @timflannagan @tjons @wendeh @williamgrh @yuval-k

I have added 12 of you to the kgateway team on CNCF FOSSA.

Yesterday's round of invitations will expire in the next 24 hours.

https://app.fossa.com/account/settings/organization/teams/85747

As Team Admins, click Add Members to add those who have accepted their invitations to the Team. The invitations are associated with the CNCF Org in FOSSA, not the team, so adding a CNCF Org User is a necessary separate step.

Importing the repos for scanning is easy. When importing repos, please remember to do so from the context of the gateway team. If a repo is imported but not assigned to a team, let me know; I can fix that.

https://docs.fossa.com/docs/quick-import

When the project's code repos are imported, I can mark this task complete.

[linsun]

Regarding Transfer [your domain to the CNCF](https://jira.linuxfoundation.org/plugins/servlet/desk/portal/2/create/63?requestGroup=19). The "LF Stakeholder email" is [[email protected]](mailto:[email protected]). The "Project" is CNCF., per @yuval-k, our kgateway.dev domain, which is part of a bundle can't be transferred within 120 days of the bundle purchase date. We'll start the transfer after March 21, 2025.

Pinged @yuval-k today offline to get started on this.

@yuval-k has submitted the transfer: https://jira.linuxfoundation.org/plugins/servlet/desk/portal/2/IT-28106

[RobertKielty]

@artberger @ashleywang1 @craigbox @danehans @EItanya @ilrudie @jenshu @kdorosh @lgadban @linsun @Nadine2016 @nfuden @npolshakova @saiskee @sam-heilbron @ilackarms @sheidkamp @shashankram @stevenctl @timflannagan @tjons @wendeh @williamgrh @yuval-k

I checked kgateway team on FOSSA, and it looks like you have not imported the project's code repos into FOSSA.

Can you PTAL? If you have any problems with completing a Quick Import, let me know here or on cloud-native Slack.

Completing the import should take about 15 minutes at most.

https://docs.fossa.com/docs/quick-import

[jenshu]

@RobertKielty I've imported the 3 repos into FOSSA.

When importing repos, please remember to do so from the context of the gateway team.

I'm not sure if I did this part correctly, can you check?

Let me know if we're missing anything else, thanks!

[RobertKielty]

@jenshu that's perfect, thank you so much. You're a ⭐

[craigbox]

The project website is offline and it appears to be due to the domain having been transferred to the LF.

Can someone with access please update the NS records ASAP? They should be gail.ns.cloudflare.com and houston.ns.cloudflare.com.

[krook]

Pinging LF IT now