docs: add blog post on local PAC dev environment#714
docs: add blog post on local PAC dev environment#714theakshaypant wants to merge 1 commit intotektoncd:mainfrom
Conversation
Add a guide for setting up a local Pipelines-as-Code development environment using the startpaac tool. Covers prerequisites, installation, GitHub App configuration, and a first pipeline run walkthrough. Signed-off-by: Akshay Pant <[email protected]>
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
tekton-robot
added
the
size/L
| ko >= 0.14 | ||
|
|
||
| # CLI utilities | ||
| gum >= 0.11 |
There was a problem hiding this comment.
i made gum optional here fyi pipelines-as-code/startpaac#21
chmouel
left a comment
chmouel
left a comment
There was a problem hiding this comment.
I think it's good but startpaac is more tailored for local devs than end user getting started, end users should probably do https://pipelinesascode.com/docs/getting-started/
| # CLI utilities | ||
| gum >= 0.11 | ||
| jq >= 1.6 | ||
| minica |
| - Tekton Triggers for advanced event handling | ||
| - Tekton Chains for supply chain security | ||
| - PostgreSQL database | ||
| - GitHub Second Controller for enterprise setups |
There was a problem hiding this comment.
for multiple multiple controller testing (ie: second github enterprise instance)
| - Contribute features back to the PAC project | ||
| - Experiment with unreleased PAC functionality | ||
|
|
||
| ## GitHub Integration Setup |
There was a problem hiding this comment.
i think you can just give tkn pac bootstrap --skip-install
| 2. Generate a **private key** and download it | ||
| 3. Install the app on your test repository | ||
|
|
||
| #### 4. Set Up Webhook Forwarding |
There was a problem hiding this comment.
tkn pac bootstrap would do it..
|
|
||
| #### 5. Create Secret Files | ||
|
|
||
| Create the secret files that startpaac expects: |
There was a problem hiding this comment.
with tkn pac bootstrap you just need to dump the secrets yaml to the disc, we can add an option to startpaac to instead read from a folder, read from a yaml which is the same as what we have on cluster..
Yes, this is in now way a guide to run PAC locally but targeted for anyone who wants to setup a dev environment, as the title also suggests "Setting Up a Local Pipelines-as-Code Development Environment". |
3 participants
Changes
Add a guide for setting up a local Pipelines-as-Code development environment using the startpaac tool. Covers prerequisites, installation, GitHub App configuration, and a first pipeline run walkthrough.
Submitter Checklist
These are the criteria that every PR should meet, please check them off as you
review them:
See the contribution guide
for more details.