Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[SANDBOX ONBOARDING] KusionStack #295

Open
21 of 30 tasks
mrbobbytables opened this issue Sep 27, 2024 · 47 comments
Open
21 of 30 tasks

[SANDBOX ONBOARDING] KusionStack #295

mrbobbytables opened this issue Sep 27, 2024 · 47 comments

Comments

@mrbobbytables
Copy link
Member

mrbobbytables commented Sep 27, 2024

Welcome to CNCF Project Onboarding

ref: #83

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.

Review and understand

Contribute and transfer

Update and document

  • Ensure that DCO (preferred) or CLA are enabled for all GitHub repositories of the project.
  • Ensure that that the CNCF Code of Conduct (or your adopted version of it) are explicitly referenced at the project's README 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 file).
  • 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].
  • Start working on written, open governance.
  • Start on an OpenSSF Best Practices Badge.

CNCF staff tasks

@mrbobbytables
Copy link
Member Author

@Cmierly this should be good to go to begin onboarding :)

@SparkYuan tagging you here as an FYI, please tag any others from the project who should follow this issue.

@mrbobbytables mrbobbytables removed their assignment Sep 27, 2024
@ffforest
Copy link

Thanks @mrbobbytables! We will follow up on the items in this issue.

@ffforest
Copy link

ffforest commented Oct 9, 2024

I am working on the following items:

  • 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.

Question about this one: Does "neutral" here represent "not in a GHE account currently"? We are planning to transfer all repositories currently under the KusionStack organization. I take it as we don't need to create a new org for that?

There are 3 private repos and 2 public-archived repos at the moment. Can they be transferred while staying private/archived, or do we need to get rid of them first?

We are also cleaning up the outdated repos and then everything else should be good to transfer.

These can be expected by the end of the week:

  • Ensure that DCO (preferred) or CLA are enabled for all GitHub repositories of the project.
  • Ensure that that the CNCF Code of Conduct (or your adopted version of it) are explicitly referenced at the project's README 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 file).
  • 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].
  • Start working on written, open governance.
  • Start on an OpenSSF Best Practices Badge.

These two might take a bit longer:

Could you please also tag the CNCF staff that can help with the following?

cc @mrbobbytables @Cmierly @idvoretskyi @krook @jeefy

@ffforest
Copy link

ffforest commented Oct 9, 2024

This artwork PR is ready for review. Since our logo is basically just words, I'm using Helm as a reference which uses the same set images for horizontal, stacked and logo.

[ ] Submit a pull request with your artwork.

@mrbobbytables
Copy link
Member Author

We are planning to transfer all repositories currently under the KusionStack organization. I take it as we don't need to create a new org for that?

Correct. 👍
If the entire org is going to be donated you don't have to worry about moving it to a separate one.

As a followup we can update the wording in the template to make that a bit more clear.

@idvoretskyi
Copy link
Member

@ffforest with the Slack migration either myself of @RobertKielty are happy to assist!

The same with:

Add a license scanning tool, like FOSSA or Snyk.

@mrbobbytables
Copy link
Member Author

Migrate your Slack channels (if any) to the Kubernetes or CNCF Slack workspace.

myself, @krook or @jeefy can help here. How many channels do you have? If its a small number the easiest method might be to manually recreate them in cncf or kubernetes slack.

@RobertKielty
Copy link

RobertKielty commented Oct 9, 2024

Hi @ffforest, for FOSSA and/or Snyk we will need one or more email addresses to invite you to join the CNCF service instances that are provided to CNCF Projects.

You send us the email addresses by emailing them to [email protected]

For FOSSA and Snyk - The email addresses you send us need to be associated with GitHub user accounts that have access to the code repos that will be scanned.

@RobertKielty
Copy link

RobertKielty commented Oct 9, 2024

@ffforest, I have made a KusionStack Team on CNCF FOSSA and a KusionStack Organziation on CNCF Snyk for the project.

@Cmierlym, I've added KusionStack to our internal records.

@ffforest
Copy link

We are planning to transfer all repositories currently under the KusionStack organization. I take it as we don't need to create a new org for that?

Correct. 👍 If the entire org is going to be donated you don't have to worry about moving it to a separate one.

As a followup we can update the wording in the template to make that a bit more clear.

Thanks @mrbobbytables!
For the private repos, can they be donated as-is, or do we have to make them public first?

@ffforest
Copy link

Migrate your Slack channels (if any) to the Kubernetes or CNCF Slack workspace.

myself, @krook or @jeefy can help here. How many channels do you have? If its a small number the easiest method might be to manually recreate them in cncf or kubernetes slack.

We have 2 channels with about 70 people in them. What would you recommend? Create a new one and redirect people to it from the existing one?

@mrbobbytables
Copy link
Member Author

as-is is fine - a good chunk of projects use private repos for things like security patch testing before pushing to public etc

@ffforest
Copy link

Hi @ffforest, for FOSSA and/or Snyk we will need one or more email addresses to invite you to join the CNCF service instances that are provided to CNCF Projects.

You send us the email addresses by emailing them to [email protected]

For FOSSA and Snyk - The email addresses you send us need to be associated with GitHub user accounts that have access to the code repos that will be scanned.

Thanks @RobertKielty!
I have just sent the email over.
Is there anything else you need on the FOSSA/Snyk front?

@RobertKielty
Copy link

For FOSSA and Snyk - The email addresses you send us need to be associated with GitHub user accounts that have access to the code repos that will be scanned.

Thanks @RobertKielty!
I have just sent the email over.
Is there anything else you need on the FOSSA/Snyk front?

That's perfect thank you. I have received the emails you have sent over. cc @Cmierly

Next step would be to state a preference for the project to use either FOSSA or Snyk.

@mrbobbytables
Copy link
Member Author

We have 2 channels with about 70 people in them. What would you recommend? Create a new one and redirect people to it from the existing one?

For that amount of users, I'd probably lean towards import. @RobertKielty @idvoretskyi would either of you be able to help?

@ffforest
Copy link

For FOSSA and Snyk - The email addresses you send us need to be associated with GitHub user accounts that have access to the code repos that will be scanned.
Thanks @RobertKielty!
I have just sent the email over.
Is there anything else you need on the FOSSA/Snyk front?

That's perfect thank you. I have received the emails you have sent over. cc @Cmierly

Next step would be to state a preference for the project to use either FOSSA or Snyk.

Absolutely. FOSSA would do.
Appreciate the help!

@RobertKielty
Copy link

@ffforest thank you!

I have emailed out FOSSA invites to the maintainer team: @SparkYuan @liu-hm19 @zuomo @wu8685 @elliotxx @Eikykun @adohe @ruquanzhao @Yangyang96 @ColdsteelRail @shaofan-hs

Please note the following:

  1. For registration with the CNCF FOSSA Organizaion, the email addresses we use to invite the team members MUST NOT be associated with any other FOSSA Organization.
  2. Once an invite is accepted I need to manually add the first team member to the Team in FOSSA. We grant Team Members the role of FOSSA Team Admin. Remaining members who sucessfully accept the their invitations to join CNCF FOSSA can be added to the new Team by the first KusionStack Team Admin or a CNCF Organziation Admin.
  3. The email addresses MUST be associated with GitHub user accounts that have read/write access to the code repos that will be imported for license scanning.

For the initial license scans of the code repos we only need one maintainer to sucessfully register and import the repos so that we can see reports on the 3rd party licenses used in the project code repos.

Feel free to have one of the maintainers reach out to me on CNCF Slack if support is required on getting setup.

If there is work to be done to bring the code repos into compliance with the 3rd Party License policy then we can focus on getting all of the maintainers on-boarded onto FOSSA.

I have sent out all of the invites, (one of the maintainers email addresses already had a FOSSA a/c associated with their email address) I will let you know who that was in my next comment.

@RobertKielty
Copy link

Hi @SparkYuan,

The email address that @ffforest passed on to us for you was already registered on FOSSA.

From a KusionStack on-boarding point of view, this is fine; as long as one of the other maintainers accepts their invite and imports the project's code repos into FOSSA then that will do for now.

If however you want to register with CNCF FOSSA now there are two options to choose from:

either

  • we can ask FOSSA Support to transfer your existing FOSSA Account over to the CNCF FOSSA Organziation.
    or
  • if you want to keep your existing FOSSA setup you can send me an alternative email address to use for CNCF FOSSA

Typically, we use the FOSSA support transfer option for accounts where a maintainer just used their email address to setup FOSSA for learning purposes and are happy to delete that account, and we use an alternate address for people who are already using FOSSA for work and need to keep using their existing FOSSA setup.

@ffforest
Copy link

ffforest commented Oct 11, 2024

Quick update:

Review and understand

Contribute and transfer

Update and document

  • Ensure that DCO (preferred) or CLA are enabled for all GitHub repositories of the project.
  • Ensure that that the CNCF Code of Conduct (or your adopted version of it) are explicitly referenced at the project's README 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 file).
  • 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].
  • Start working on written, open governance.
  • Start on an OpenSSF Best Practices Badge.

@ffforest
Copy link

@ffforest thank you!

I have emailed out FOSSA invites to the maintainer team: @SparkYuan @liu-hm19 @zuomo @wu8685 @elliotxx @Eikykun @adohe @ruquanzhao @Yangyang96 @ColdsteelRail @shaofan-hs

Please note the following:

  1. For registration with the CNCF FOSSA Organizaion, the email addresses we use to invite the team members MUST NOT be associated with any other FOSSA Organization.
  2. Once an invite is accepted I need to manually add the first team member to the Team in FOSSA. We grant Team Members the role of FOSSA Team Admin. Remaining members who sucessfully accept the their invitations to join CNCF FOSSA can be added to the new Team by the first KusionStack Team Admin or a CNCF Organziation Admin.
  3. The email addresses MUST be associated with GitHub user accounts that have read/write access to the code repos that will be imported for license scanning.

For the initial license scans of the code repos we only need one maintainer to sucessfully register and import the repos so that we can see reports on the 3rd party licenses used in the project code repos.

Feel free to have one of the maintainers reach out to me on CNCF Slack if support is required on getting setup.

If there is work to be done to bring the code repos into compliance with the 3rd Party License policy then we can focus on getting all of the maintainers on-boarded onto FOSSA.

I have sent out all of the invites, (one of the maintainers email addresses already had a FOSSA a/c associated with their email address) I will let you know who that was in my next comment.

Thank you @RobertKielty! I have just signed up and joined the CNCF FOSSA Org. My email is [email protected].

@RobertKielty
Copy link

RobertKielty commented Oct 11, 2024

@Eikykun Thank you for accepting the FOSSA invite!

I have added you to the KusionStack Team in CNCF FOSSA as a Team Admin.

As a Team Admin when the rest of your colleagues accept their invites you will be able to add them to the Team on CNCF FOSSA. Be sure to also give your colleagues the Team Admin role so that they can self-serve on team administration tasks. For a description of the Team Admin Role within FOSSA see:

https://docs.fossa.com/docs/role-based-access-control#team-roles

The next step now is to import the KusionStack code repos into FOSSA

You can follow the instructions to import a project repos here

https://docs.fossa.com/docs/getting-started#importing-a-project

Important Notes:

  1. Use the user account we have just set up for you
  2. Use Team we have set up to import your code repos

If you need any support in getting a repo import completed, let me know, I am only 7hrs ahead of you. Typically, the import task takes a few minutes to setup and the first scans will start soon after setup is complete. From there, merging new Pull Requests will trigger scans on FOSSA.

@Eikykun
Copy link

Eikykun commented Oct 11, 2024

@RobertKielty thank you! 😺

@ffforest I have added you as a team admin. Thank you for taking care of the next steps.

@ffforest
Copy link

ffforest commented Oct 15, 2024

Update on 10/15:

Welcome to CNCF Project Onboarding

ref: #83

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.

Review and understand

Contribute and transfer

Update and document

  • Ensure that DCO (preferred) or CLA are enabled for all GitHub repositories of the project.
  • Ensure that that the CNCF Code of Conduct (or your adopted version of it) are explicitly referenced at the project's README 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 file).
  • 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].
  • Start working on written, open governance.
  • Start on an OpenSSF Best Practices Badge.

CNCF staff tasks

@ffforest
Copy link

Items needing assistance from the CNCF:

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.

Could you please send the invite? The organization is KusionStack.

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

We are using Google Analytics. Does this involve the transfer of a Google Analytics account?

Migrate your Slack channels (if any) to the Kubernetes or CNCF Slack workspace. CNCF staff can help.

I'm preparing the export file. Where should I send the file to?

Add the project to DevStats. @lukaszgryglicki
Add the project to CLOmonitor. @cynthia-sg
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.
Add the project to LFX Project Control Center.
Invite developers to the #maintainers-circle Slack channel.
Send a welcome email to confirm maintainer list access.

Could you please let me know if you could help with these?

cc @caniszczyk @mrbobbytables @Cmierly @idvoretskyi @RobertKielty @jeefy @krook

@idvoretskyi
Copy link
Member

Could you please send the invite? The organization is KusionStack.

Invite sent!

I'm preparing the export file. Where should I send the file to?

Can you please submit a ServiceDesk ticket, we'll proceed from there.

@ffforest
Copy link

Can you please submit a ServiceDesk ticket, we'll proceed from there.

@idvoretskyi I'm assuming you mean https://cncfservicedesk.atlassian.net/servicedesk/customer/portal/1 but I'm not able to log in there. I did send an email (titled KusionStack Sandbox Onboarding - Maintainers Emails) to [email protected] last week but perhaps it wasn't processed yet.
Image

I am able to submit a ticket via the LF service though but there are no Slack-related service there.

@ffforest
Copy link

Regarding this one

Transfer any trademark and logo assets to the Linux Foundation.

The agreement also mentions the transfer of social media accounts and such. We have a KusionStack account for X and Medium. Are they expected to transferred during onboarding? If so, how is that done (do we provide the username and password)? I'm assuming we are still in charge of producing contents for each.

Procedure-wise, I understand that we are expected to send a signed copy to [email protected], after which we will receive a mutually signed copy back.

cc @mrbobbytables @RobertKielty @idvoretskyi

@ffforest
Copy link

@RobertKielty
Regarding FOSSA license scan results:

What is the expected response for (and time window to address) the issues exposed in the license scan? I noticed some of them are common issues among CNCF projects (dual licenses in vendor projects, etc). Do we need to provide a detailed comment in FOSSA with explanation for each of the issue (I've seen people done that for other projects but I don't have the permission to create a comment yet) and proceed to click ignore on the issue?

@RobertKielty
Copy link

RobertKielty commented Oct 15, 2024

@ffforest - on timelines for working through the reported license issues I think that is something the KusionStack project team should work on while the project is in the Sandbox.

For 3rd party dependancies that are dual licensed they must be wholly licenseable under a permitted license as described in https://github.com/cncf/foundation/blob/main/allowed-third-party-license-policy.md#approved-licenses-for-allowlist

For onboarding, getting repos scanned by FOSSA is the necessary task to complete. If you have contributors who can look at the reported issues now that is perfect.

One piece of feedback that I have is that the CNCF 3rd Pary License policy is for code repositories belonging to a project that releases artifacts to end-users. So I think it it OK to not scan the .github repo or the website repos. I will run this by @jeefy @krook @mrbobbytables to confirm this.
EDIT:
All of the repositories need to be scanned! I checked this with my colleagues on the CNCF Projects team after writing this last paragraph.

Also on that call I learned that documentation repos need to be licensed under the Creative Commons Attribution 4.0 International License as described in https://github.com/cncf/foundation/blob/main/charter.md#11-ip-policy

Thank you @jeefy and @mrbobbytables!

@mrbobbytables
Copy link
Member Author

mrbobbytables commented Oct 15, 2024

EDIT: NM - thought of .github, not website - both need licenses.^^;;;

@ffforest
Copy link

ffforest commented Oct 16, 2024

@ffforest - on timelines for working through the reported license issues I think that is something the KusionStack project team should work on while the project is in the Sandbox.

For 3rd party dependancies that are dual licensed they must be wholly licenseable under a permitted license as described in https://github.com/cncf/foundation/blob/main/allowed-third-party-license-policy.md#approved-licenses-for-allowlist

For onboarding, getting repos scanned by FOSSA is the necessary task to complete. If you have contributors who can look at the reported issues now that is perfect.

One piece of feedback that I have is that the CNCF 3rd Pary License policy is for code repositories belonging to a project that releases artifacts to end-users. So I think it it OK to not scan the .github repo or the website repos. I will run this by @jeefy @krook @mrbobbytables to confirm this. EDIT: All of the repositories need to be scanned! I checked this with my colleagues on the CNCF Projects team after writing this last paragraph.

Also on that call I learned that documentation repos need to be licensed under the Creative Commons Attribution 4.0 International License as described in https://github.com/cncf/foundation/blob/main/charter.md#11-ip-policy

Thank you @jeefy and @mrbobbytables!

Thanks @RobertKielty and @mrbobbytables for the quick response!

For 3rd party dependancies that are dual licensed they must be wholly licenseable under a permitted license as described in https://github.com/cncf/foundation/blob/main/allowed-third-party-license-policy.md#approved-licenses-for-allowlist

Yes I'm aware of this list. I went through the full list of issues identified and most of them are accounted for (all of the licenses linked below are using the proper versions for dependencies in the KusionStack projects):

Can the above be properly ignored with a comment stating the same?

This is the only one I'm currently not very clear on:

@ffforest
Copy link

EDIT: NM - thought of .github, not website - both need licenses.^^;;;

@mrbobbytables Just to clarify, do you mean both .github and website repos need licenses or do they both need Creative Commons Attribution 4.0 International License?

@ffforest
Copy link

ffforest commented Oct 16, 2024

Currently Open PRs:

@lukaszgryglicki
Copy link
Member

DevStats instance created.

@lukaszgryglicki
Copy link
Member

Added to All CNCF (also here) and regenerated all its data (including past).

@ffforest
Copy link

ffforest commented Oct 23, 2024

Following up on these items:

Migrate your Slack channels (if any) to the Kubernetes or CNCF Slack workspace. CNCF staff can help.

I still don't have access to CNCF Service Desk to create a ticket for this. An email (titled KusionStack Sandbox Onboarding - Maintainers Emails) was send to [email protected] couple days ago. Can you please check if it has been processed?

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

Not clear on how to proceed on this one. Are we expected to transfer the Google Analytics account?

These are also pending:

Add the project to CLOmonitor. @cynthia-sg
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.
Add the project to LFX Project Control Center.
Invite developers to the #maintainers-circle Slack channel.
Send a welcome email to confirm maintainer list access.

I'm working on these two:

Transfer your domain to the CNCF. The "LF Stakeholder email" is [email protected].
Transfer any trademark and logo assets to the Linux Foundation.

cc @RobertKielty @jeefy @krook @Cmierly @mrbobbytables
Thank you for your patient support!

@Cmierly
Copy link

Cmierly commented Oct 23, 2024

@ffforest I have sent out invites to add your maintainers to service desk. Let me know if you have any issues accepting the invite or need it resent

@ffforest
Copy link

ffforest commented Oct 24, 2024

@ffforest I have sent out invites to add your maintainers to service desk. Let me know if you have any issues accepting the invite or need it resent

Thanks @Cmierly !
I have created a ticket for migrating our Slack channels. The ticket ID is CNCFSD-2523. The exported file is attached in the ticket. cc @idvoretskyi
Please let me know if you need anything else.

@idvoretskyi
Copy link
Member

I have created a ticket for migrating our Slack channels. The ticket ID is CNCFSD-2523. The exported file is attached in the ticket. cc @idvoretskyi

Done! Please check.

@cynthia-sg
Copy link

Project has been added to CLOMonitor

@ffforest
Copy link

Thank you @idvoretskyi and @cynthia-sg !
The slack channel looks good.

@ffforest
Copy link

ffforest commented Oct 25, 2024

Transfer any trademark and logo assets to the Linux Foundation.

Regarding this agreement, our legal team has made some modifications. To highlight the key changes for your review:

  1. Omission of exhibit B due to its inapplicability in practice. We need different documentation for the transfer of KusionStack's trademarks to LF, which can be prepared by LF's attorneys or by Ant.
  2. Addition of 5) governing law, which is imperative to us.
  3. Designation of Advanced New Technologies, the holder of Ant's trademarks, as the assignor.

KusionStack Trademark and Account Assignment Agreement - Ant Edits.pdf

Please review the revised document and let me know if you have any questions or require further clarifications.

cc @caniszczyk @mrbobbytables @RobertKielty @jeefy @krook @Cmierly

Edit: Relevant question: The agreement also mentions the transfer of social media accounts and such. We have a KusionStack account for X and Medium. Are they expected to transferred during onboarding? If so, how is that done (do we provide the username and password)?

@krook krook changed the title [SANDBOX PROJECT ONBOARDING] KusionStack [SANDBOX ONBOARDING] KusionStack Oct 25, 2024
@Cmierly
Copy link

Cmierly commented Oct 29, 2024

Thank you @ffforest !
I'll have our legal team review the changes and let you know if anything comes up

@ffforest
Copy link

ffforest commented Nov 7, 2024

Thank you @ffforest ! I'll have our legal team review the changes and let you know if anything comes up

Hi @Cmierly, following up on this one. Is there any update?

@ffforest
Copy link

Thank you @ffforest ! I'll have our legal team review the changes and let you know if anything comes up

Hi @Cmierly, following up on this one. Is there any update?

Hi @Cmierly, checking in again. Is there any update or anything we could do to move this forward?

@Cmierly
Copy link

Cmierly commented Nov 14, 2024

hi @ffforest !
Unfortunately, we are held up as legal is devising a new method of accepting trademarks. We are pushing for info but it's going a bit slow. I'm terribly sorry for the delay!

@ffforest
Copy link

hi @ffforest ! Unfortunately, we are held up as legal is devising a new method of accepting trademarks. We are pushing for info but it's going a bit slow. I'm terribly sorry for the delay!

Thanks for the update @Cmierly. Is there an approximate ETA for this?
Also, does this mean we are modifying parts of the agreement or will there be a completely new agreement? Asking because there were some work on our end to transfer the domain that was previously waiting on the agreement to be signed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests