Skip to content

Commit 6137eb2

Browse files
openshift-ci[bot]grokspawn
authored andcommitted
Merge pull request openshift#602 from tmshort/update-docs
NO-ISSUE: Update downstreaming documentation.
2 parents 57e26f0 + 2765998 commit 6137eb2

File tree

6 files changed

+52
-12
lines changed

6 files changed

+52
-12
lines changed

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,3 +14,5 @@ above), and then downstreamed to this repository.
1414

1515
Please refer to the [scripts README.md](scripts/README.md) to learn how to
1616
downstream commits from those projects to this repo.
17+
18+
A [TestGrid](https://testgrid.k8s.io/redhat-openshift-olm) is configured for this repository.

go.mod

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -256,10 +256,4 @@ replace (
256256
github.com/operator-framework/api => ./staging/api
257257
github.com/operator-framework/operator-lifecycle-manager => ./staging/operator-lifecycle-manager
258258
github.com/operator-framework/operator-registry => ./staging/operator-registry
259-
260-
// this should be removeable once https://issues.redhat.com/browse/CLOUDBLD-11068 is resolved
261-
k8s.io/pod-security-admission => k8s.io/pod-security-admission v0.25.0
262-
263-
// pinned because no tag supports 1.18 yet
264-
sigs.k8s.io/structured-merge-diff => sigs.k8s.io/structured-merge-diff v1.0.1-0.20191108220359-b1b620dd3f06
265259
)

manifests/0000_50_olm_00-clusterserviceversions.crd.yaml

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1700,7 +1700,11 @@ spec:
17001700
type: object
17011701
properties:
17021702
claims:
1703+
<<<<<<< HEAD
17031704
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable. It can only be set for containers."
1705+
=======
1706+
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable."
1707+
>>>>>>> 07c80820c (bump golang-migrate to v4.16.1 (#1107))
17041708
type: array
17051709
items:
17061710
description: ResourceClaim references one entry in PodSpec.ResourceClaims.
@@ -2544,7 +2548,11 @@ spec:
25442548
type: object
25452549
properties:
25462550
claims:
2551+
<<<<<<< HEAD
25472552
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable. It can only be set for containers."
2553+
=======
2554+
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable."
2555+
>>>>>>> 07c80820c (bump golang-migrate to v4.16.1 (#1107))
25482556
type: array
25492557
items:
25502558
description: ResourceClaim references one entry in PodSpec.ResourceClaims.
@@ -3399,7 +3407,11 @@ spec:
33993407
type: object
34003408
properties:
34013409
claims:
3410+
<<<<<<< HEAD
34023411
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable. It can only be set for containers."
3412+
=======
3413+
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable."
3414+
>>>>>>> 07c80820c (bump golang-migrate to v4.16.1 (#1107))
34033415
type: array
34043416
items:
34053417
description: ResourceClaim references one entry in PodSpec.ResourceClaims.
@@ -3766,7 +3778,11 @@ spec:
37663778
description: If specified, the pod will be dispatched by specified scheduler. If not specified, the pod will be dispatched by default scheduler.
37673779
type: string
37683780
schedulingGates:
3781+
<<<<<<< HEAD
37693782
description: "SchedulingGates is an opaque list of values that if specified will block scheduling the pod. If schedulingGates is not empty, the pod will stay in the SchedulingGated state and the scheduler will not attempt to schedule the pod. \n SchedulingGates can only be set at pod creation time, and be removed only afterwards. \n This is a beta feature enabled by the PodSchedulingReadiness feature gate."
3783+
=======
3784+
description: "SchedulingGates is an opaque list of values that if specified will block scheduling the pod. More info: https://git.k8s.io/enhancements/keps/sig-scheduling/3521-pod-scheduling-readiness. \n This is an alpha-level feature enabled by PodSchedulingReadiness feature gate."
3785+
>>>>>>> 07c80820c (bump golang-migrate to v4.16.1 (#1107))
37703786
type: array
37713787
items:
37723788
description: PodSchedulingGate is associated to a Pod to guard its scheduling.
@@ -4294,7 +4310,11 @@ spec:
42944310
type: object
42954311
properties:
42964312
claims:
4313+
<<<<<<< HEAD
42974314
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable. It can only be set for containers."
4315+
=======
4316+
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable."
4317+
>>>>>>> 07c80820c (bump golang-migrate to v4.16.1 (#1107))
42984318
type: array
42994319
items:
43004320
description: ResourceClaim references one entry in PodSpec.ResourceClaims.

manifests/0000_50_olm_00-subscriptions.crd.yaml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -647,7 +647,11 @@ spec:
647647
type: object
648648
properties:
649649
claims:
650+
<<<<<<< HEAD
650651
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable. It can only be set for containers."
652+
=======
653+
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable."
654+
>>>>>>> 07c80820c (bump golang-migrate to v4.16.1 (#1107))
651655
type: array
652656
items:
653657
description: ResourceClaim references one entry in PodSpec.ResourceClaims.
@@ -1073,7 +1077,11 @@ spec:
10731077
type: object
10741078
properties:
10751079
claims:
1080+
<<<<<<< HEAD
10761081
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable. It can only be set for containers."
1082+
=======
1083+
description: "Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. \n This is an alpha field and requires enabling the DynamicResourceAllocation feature gate. \n This field is immutable."
1084+
>>>>>>> 07c80820c (bump golang-migrate to v4.16.1 (#1107))
10771085
type: array
10781086
items:
10791087
description: ResourceClaim references one entry in PodSpec.ResourceClaims.

scripts/README.md

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,17 @@ All of the staged repositories live in the top level `staging` directory.
55
The downstreaming process is complex and helper scripts have been written
66
to facilitate downstreaming.
77

8+
## Automatic Downstreaming
9+
10+
There is now an automated downstreaming process for OLMv0 from the three
11+
source repositories.
12+
13+
The "bumper" program is located in [openshift/operator-framework-tooling](https://github.com/openshift/operator-framework-tooling).
14+
It is automatically run on a daily basis based on the following [openshift/release](https://github.com/openshift/release/blob/3bf0b3ae011debaefefb564ad6f233c380d033f7/ci-operator/jobs/infra-periodics.yaml#L926-L978) config.
15+
16+
If the bumper program fails to create a mergeable PR, manual intervention will be necessary.
17+
This may require copying, modifying and resubmitting the PR.
18+
819
## Assumptions
920

1021
The helper scripts assume that the upstream remote repos are configured
@@ -19,6 +30,9 @@ remote repositories.
1930

2031
## Bulk Sync
2132

33+
**NOTE**: This should no longer be necessary, given the "bumper" program above.
34+
The "bumper" program can be used instead of the following process.
35+
2236
To sync all current changes from upstream, simply run the sync script:
2337
```sh
2438
scripts/sync.sh
@@ -54,14 +68,18 @@ file in the repositry root directory with the repos and commit SHAs.
5468

5569
The format of the cherrypick file is:
5670
```
57-
<order> <repo> <commit-SHA>
71+
<date-order> <commit-order> <repo> <commit-SHA>
5872
```
5973

74+
* The `<date-order>` field is usually an ISO date without spaces.
75+
* The `<commit-order>` field is a sequential number indicating the order of a commit within a pull request.
76+
* For this _manual_ purpose, both can just be the same sequential number.
77+
6078
For example:
6179
```
62-
1 api 0123456789abcdef0123456789abcdef01234567
63-
2 operator-lifecycle-manager 123456789abcdef0123456789abcdef012345678
64-
3 operator-lifecycle-manager 23456789abcdef0123456789abcdef0123456789
80+
1 1 api 0123456789abcdef0123456789abcdef01234567
81+
2 2 operator-lifecycle-manager 123456789abcdef0123456789abcdef012345678
82+
3 3 operator-lifecycle-manager 23456789abcdef0123456789abcdef0123456789
6583
```
6684
Do _not_ commit the cherrypick file, it is a temporary working file that
6785
is ignored by `git`.

vendor/modules.txt

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2263,5 +2263,3 @@ sigs.k8s.io/yaml
22632263
# github.com/operator-framework/api => ./staging/api
22642264
# github.com/operator-framework/operator-lifecycle-manager => ./staging/operator-lifecycle-manager
22652265
# github.com/operator-framework/operator-registry => ./staging/operator-registry
2266-
# k8s.io/pod-security-admission => k8s.io/pod-security-admission v0.25.0
2267-
# sigs.k8s.io/structured-merge-diff => sigs.k8s.io/structured-merge-diff v1.0.1-0.20191108220359-b1b620dd3f06

0 commit comments

Comments
 (0)