Review Charm for Listing

Hello team!

Could you please review lego-operator for listing on charmhub?

This is a certificate provider charm that allows getting certificates from an ACME server like Let’s Encrypt by utilising the Lego library. The charm can be deployed both on machine and k8s and it is developed and maintained by the identity-credentials team.

Metadata links

CI Links

Workflow files are centralised in a common repository and those are used in the main workflow of this charm.

Documentation Links

1 Like

Thanks @yazansalti for the review request!

@javierdelapuente can you please help with this review? You can go through and tick off the items on the checklist as well as the provider PR and post the result in this thread. This prior listing request could serve as an example of how to go about it. Please ping me or anyone else from Charm-Tech for any questions.

Sure, I will review it.

1 Like

Hi!

It is a really nice charm providing very important functionality! Congratulations for it!

I have reviewed the PR and added a few minor comments. I have aproved the PR, as I think none of them is major.

I have also tested the project. It worked flawlessly using the ovh provider.

I think it would be nice to add a logo for the project.

1 Like

Here is the checklist. I think it is good to go, but it would be nice to address the comments in the previous post.

Checked Review item Objective Review criteria
Intended functionality Despite all the items for publication readiness, the charm must work. Charm does what it is meant to do - ideally done in a demo.
Charmhub.io charm detail page A complete and consistent appearance of the charm is required for a quality impression of the charm collection. The overall appearance looks good, which means:
* The name complies with the naming guidelines.
* The publisher is identified.
* The links are provided.
* The documentation looks reasonable.
Source repository Generally, the source code for charms must be accessible by the community for transparency and collaboration. It is not entirely mandatory to have the charm published as OSS for review, but the repository must be accessible from the persons working on the review request.
Coding conventions The source code of the charm is accessible in the sense of approachability. Consistent source code style and formatting are also considered a sign of being committed to quality. The implemented checks for coding conventions are reasonable and implemented in the regular CI/CD implementation.
Release automation implementation An implementation for automated releasing to charmhub.io improves the ability to provide updates covering vulnerabilities quickly. Release automation for unstable channels to enable testing when new versions of the charm code or the workload become available.
Unit tests implementation In particular, for the charms review, assuring a reasonable test suite is essential to allow for automated releases in future. The unit tests show relevant coverage. It is a case-dependent review.At the time of review, the test runs successfully.
Unit tests results Availability of test results is mandatory for a working collaborative project. URL to test results from CI/CD automation.
Installation test implemented (could be part of the integration test) In particular, for the charm review, assuring a reasonable test suite is essential to allow for automated releases in future. With this test, for every build, it is ensured that the installation is successful. An implementation for checking the installation is present. The implementation should also check for successful installation as part of the automation, and the workload behaves as expected. At the time of review, the test runs successfully.
Installation test results Availability of test results is mandatory for a working collaborative project. URL to test results from CI/CD automation.
Integration tests implemented In particular for the review of charms, assuring a reasonable test suite is important to allow for automated releases in future. With this test, for every build, it is ensured that the integration with other charms is successful. An implementation for testing the required integrations (if applicable) is present. The implementation should also check for successful integration as part of he automation and the workload behaves as expected.
At the time of review, the test runs successfully.
Integration test results Availability of test results is mandatory for a working collaborative project. URL to test results from CI/CD automation.
Documentation for usage The documentation for using the charm should be separate from the documentation for developing or contributing to the charm. URL to this documentation is present.
Documentation for contributing The documentation for contributing to the charm should be separate from the documentation for developing or using the charm. URL to this documentation is present.
Licensing statement For the charm shared, OSS or not, the licensing terms of the charm are clarified (which also implies an identified authorship of the charm). URL to the ruling licensing statement is present.
1 Like

Thank you very much for your review and comments @javierdelapuente .

I have addressed them in this PR.

Let me know if there is anything else I can do.

From my side, it’s good to go! @tony-meyer

Thanks @javierdelapuente ! (And @yazansalti ).

@odysseus-k This one should be good for listing now, thanks!

Hi @tony-meyer,

This is now done. FYI, @adityagoel28 will soon start handling these requests so please tag him as well from now on.

Thanks,

Odysseus

2 Likes

Hi @odysseus-k

Thank you, but I still don’t get results when I look for “lego” in Charmhub. Am I missing anything that needs to be done on my end?

Hi @yazansalti , we are investigating the issue.
So please give us some time, will update soon here.

@abbiesims can you pls let us know if there some known issue why this is not being reflected on the Charmhub UI page or something the team need to look into?
We can see that the info is correctly updated in the prod database.

Regards,
Aditya

1 Like

Hi @adityagoel28, there’s nothing obvious sticking out to me to explain why the charm isn’t showing up in search. It is not being returned from the find API so I don’t think the issue is related to the front end.

Thanks @abbiesims for the quick response.

@yazansalti I think I found the issue. The reason your charm is not showing up on Charmhub.io is because the charm doesn’t have a default track. Charms will not show up unless they are defaulted to a channel that has a stable release.

Your two options would be to change the default track to 4 (which I can do). That should fix the issue. Option two would be to release a revision to latest/stable.

Please let me know what you would like to do.

Thanks,
Aditya

1 Like

Hi @adityagoel28 !

Thanks for looking into this. Yes could you please change the default track to 4?

Thanks, Yazan

I have updated your default track.

The charm should be listed on charmhub.io when you make a new release to 4/stable.

Charms exhibit an interesting behavior where the refresh happens after a default track is updated and after a release is made to that default track. Releasing to 4/stable should solve the issue of the charm being unlisted in the UI.

Please do let me know in case of any issues. Happy to help!

Regards,
Aditya

1 Like

I can see it now. Thank you very much @adityagoel28

2 Likes