Skip to content

Conversation

@YasenT
Copy link
Contributor

@YasenT YasenT commented Nov 24, 2025

Documenting the pulp-access-controller as a Konflux add-on

@YasenT YasenT requested a review from a team as a code owner November 24, 2025 12:35
@ralphbean ralphbean mentioned this pull request Nov 24, 2025
@@ -0,0 +1,198 @@
---
title: Pulp Access Controller
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for opening the adr.
I have basic questions, what is pulp and why Konflux users need to access it?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi, pulp is redhat`s offering for centrally storing artifacts. Initially RPM, but today it's the go-to place for storing any language artifacts, excluding OCI type ones. So for an example, if you are producing RPMs during a Konflux job, and you want to storage them and redistribute them through the native RPM tools (yum/dnf), you would want to store them in Pulp. Does this help?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This would be good preamble to add to the top of the # Context section.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

good point, I added it.


### Basic setup

First, create a secret with your TLS certificate and key:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is the point in asking the user to create the certificates when the controller gets access to the private key the user generated?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need to present the key during TLS handshake with console.redhat.com. But we can't generate it, because it's provided by the IT team.

```

That's it. The controller will:
1. Read your credentials from `my-pulp-creds`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This controller has read access to all the secrets in the cluster?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the namespace of the user, not the whole cluster. The controller generates a secret, and reads a secret provided by the user. And we went with the idea of the user storing their cert in a secret to make it easier for any CI/CD type of implementation, safer. The actual certificates don't become part of what is store in git.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm a bit confused, who is the user (can there be more than one user)? in which namespace does the tls certificate should be created?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The user would be the owner of the namespace in a way. If they need integration with pulp, they use our controller to setup their domain config, the storage config for the domain, inside pulp itself (it's a hosted service). Without having to contact us, it's meant as an onboarding helper. And than the controller also gives them a pre-populated config file for pulp-cli. And each user would use it to create a secret inside their namespace. This is how it's used today

@snyk-io
Copy link

snyk-io bot commented Dec 4, 2025

Snyk checks have passed. No issues have been found so far.

Status Scanner Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues
Licenses 0 0 0 0 0 issues
Code Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

@YasenT YasenT requested a review from gbenhaim December 8, 2025 12:09
@YasenT YasenT requested a review from ralphbean December 16, 2025 10:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants