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.

Sign up for GitHub

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

Jump to bottom

Beta documentation: write up alternatives to PipelineResources if they remain Alpha #1369

Closed
ghost opened this issue Sep 30, 2019 · 4 comments · Fixed by #2447
Closed

Beta documentation: write up alternatives to PipelineResources if they remain Alpha #1369

ghost opened this issue Sep 30, 2019 · 4 comments · Fixed by #2447
Assignees
@vdemeester
Labels
area/api Indicates an issue or PR that deals with the API. area/release Indicates an issue on release (process, tasks). kind/documentation Categorizes issue or PR as related to documentation.
Milestone
Pipelines 0.12 🐱

Comments

@ghost
Copy link

ghost commented Sep 30, 2019

Expected Behavior

Clearly documented approach to passing files, folders, docker images, cluster information, auth information, repo information etc etc without relying on PipelineResources.

Actual Behavior

At the moment our docs assume that PipelineResources are "the answer" to modelling meaningful resources external to the CI/CD system. In the most recent PipelineResource working group we landed on the idea of keeping PipelineResources as Alpha when the rest of the Tekton resources move to Beta. So with that approach we'll need to make sure that our docs correctly reflect the "right" way to work with external resources.
@ghost ghost added kind/documentation Categorizes issue or PR as related to documentation. area/api Indicates an issue or PR that deals with the API. area/release Indicates an issue on release (process, tasks). labels Sep 30, 2019
@vdemeester vdemeester self-assigned this Oct 1, 2019
@bobcatfish bobcatfish added this to the Pipelines 0.9 🐱 milestone Oct 1, 2019
This was referenced Oct 3, 2019
Closed
Closed
vdemeester added a commit to vdemeester/tektoncd-catalog that referenced this issue Nov 6, 2019
@vdemeester
Add a git task to clone a repository without PipelineResource
178dc52 
This is part of documenting and providing Tasks in the catalog that
would help user not using PipelineResource.

Related to [tektoncd/pipeline#1369](tektoncd/pipeline#1369).

Signed-off-by: Vincent Demeester <[email protected]>
@vdemeester vdemeester mentioned this issue Nov 6, 2019
Merged
2 tasks
This was referenced Nov 25, 2019
Closed
Open
vdemeester added a commit to vdemeester/tektoncd-catalog that referenced this issue Dec 16, 2019
@vdemeester
Add a git task to clone a repository without PipelineResource
ee1d545 
This is part of documenting and providing Tasks in the catalog that
would help user not using PipelineResource.

Related to [tektoncd/pipeline#1369](tektoncd/pipeline#1369).

Signed-off-by: Vincent Demeester <[email protected]>
vdemeester added a commit to vdemeester/tektoncd-catalog that referenced this issue Dec 16, 2019
@vdemeester
Add a git task to clone a repository without PipelineResource
72e7446 
This is part of documenting and providing Tasks in the catalog that
would help user not using PipelineResource.

Related to [tektoncd/pipeline#1369](tektoncd/pipeline#1369).

Signed-off-by: Vincent Demeester <[email protected]>
@vdemeester vdemeester mentioned this issue Feb 10, 2020
Closed
tekton-robot pushed a commit to tektoncd/catalog that referenced this issue Feb 13, 2020
@vdemeester @tekton-robot
Add a git task to clone a repository without PipelineResource
bac8db4 
This is part of documenting and providing Tasks in the catalog that
would help user not using PipelineResource.

Related to [tektoncd/pipeline#1369](tektoncd/pipeline#1369).

Signed-off-by: Vincent Demeester <[email protected]>
@anneqm
Copy link

anneqm commented Mar 4, 2020

@vdemeester can we add a must have for Beta to this issue?

@vdemeester vdemeester added the kind/beta-blocking Categorizes issue or PR as related to the beta api label Mar 4, 2020
@bobcatfish
Copy link
Collaborator

@vdemeester @afrittoli @dibyom and I discussed today: at the very least we should have a doc explaining the current state and weighing pros and cons of how you do things with and without PipelineResources

@bobcatfish
Copy link
Collaborator

Note we are also making progress with Task equivalents of PipelineResources in tektoncd/catalog#95

@vdemeester vdemeester removed this from the Pipelines 0.11 🐱 milestone Mar 30, 2020
@vdemeester vdemeester added this to the Pipelines Post-beta 🐱 milestone Mar 30, 2020
@ghost ghost removed the kind/beta-blocking Categorizes issue or PR as related to the beta api label Mar 30, 2020
@adrianriobo adrianriobo mentioned this issue Mar 31, 2020
Closed
@bobcatfish bobcatfish modified the milestones: Pipelines Post-beta 🐱, Pipelines 0.12 🐱 Apr 6, 2020
@ghost
Copy link
Author

ghost commented Apr 8, 2020

First version of migration doc now exists: https://github.com/tektoncd/pipeline/blob/master/docs/migrating-v1alpha1-to-v1beta1.md

@ghost ghost mentioned this issue Apr 20, 2020
Merged
2 tasks
divyansh42 added a commit to divyansh42/pipeline that referenced this issue May 19, 2020
@divyansh42
Add replacement for cluster resource in "v1alpha1 to v1beta1 migratio…
b750fb4 
…n" docs

This is part of providing documentation for alternative to pipeline resource.
As we have now kubeconfig-creator task in the catalog as the replacement for cluster resource,
Added the same in the "v1alpha1 to v1beta1 migration" docs.
Ref: tektoncd#1369

Signed-off-by: Divyansh42 <[email protected]>
@divyansh42 divyansh42 mentioned this issue May 19, 2020
Merged
3 tasks
tekton-robot pushed a commit that referenced this issue May 19, 2020
@divyansh42 @tekton-robot
Add replacement for cluster resource in "v1alpha1 to v1beta1 migratio…
ebae092 
…n" docs

This is part of providing documentation for alternative to pipeline resource.
As we have now kubeconfig-creator task in the catalog as the replacement for cluster resource,
Added the same in the "v1alpha1 to v1beta1 migration" docs.
Ref: #1369

Signed-off-by: Divyansh42 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@vdemeester vdemeester

Labels
area/api Indicates an issue or PR that deals with the API. area/release Indicates an issue on release (process, tasks). kind/documentation Categorizes issue or PR as related to documentation.
Projects
None yet
Milestone
Pipelines 0.12 🐱
Development

Successfully merging a pull request may close this issue.

Document PipelineResource's Alpha State
3 participants
@vdemeester @bobcatfish @anneqm