Skip to content

Commit 6f2c396

Browse files
committed
Update docs to point to providers sourced from xpkg.crossplane.io. Remove terminology related to Upbound Marketplace
Signed-off-by: Craig D Wilhite <[email protected]>
1 parent 992b618 commit 6f2c396

File tree

97 files changed

+554
-702
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

97 files changed

+554
-702
lines changed

content/contribute/features.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -195,7 +195,7 @@ without using the
195195

196196
For example,
197197
```markdown
198-
[Go to Upbound](http://upbound.io)
198+
[Go to Crossplane](http://crossplane.io)
199199
```
200200

201201
## Tables

content/master/cli/command-reference.md

Lines changed: 16 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -240,9 +240,6 @@ For example,
240240

241241
Include YAML files demonstrating how to use the package with `--examples-root`.
242242

243-
[Upbound Marketplace](https://marketplace.upbound.io/) uses files included with
244-
`--examples-root` as documentation for published packages.
245-
246243
#### Include a runtime image
247244

248245
Functions and Providers require YAML files describing their dependencies and
@@ -326,9 +323,9 @@ inside Crossplane.
326323
The `<package-kind>` is either a `configuration`, `function` or `provider`.
327324

328325
For example, to install the latest version of the
329-
[AWS S3 provider](https://marketplace.upbound.io/providers/upbound/provider-aws-s3/):
326+
[AWS S3 provider](https://github.com/crossplane-contrib/provider-upjet-aws):
330327

331-
`crossplane xpkg install provider xpkg.upbound.io/upbound/provider-aws-s3:v1`
328+
`crossplane xpkg install provider xpkg.crossplane.io/crossplane-contrib/provider-aws-s3:v1.20.1`
332329

333330
#### Flags
334331
{{< table "table table-sm table-striped">}}
@@ -380,11 +377,7 @@ in the package documentation.
380377

381378
### xpkg login
382379

383-
Use `xpkg login` to authenticate to `xpkg.upbound.io`, the
384-
[Upbound Marketplace](https://marketplace.upbound.io/) container registry.
385-
386-
[Register with the Upbound Marketplace](https://accounts.upbound.io/register)
387-
to push packages and create private repositories.
380+
Use `xpkg login` to authenticate to `xpkg.crossplane.io`, the [crossplane-contrib](https://github.com/orgs/crossplane-contrib/packages) GitHub Container Registry used by the Crossplane project.
388381

389382
#### Flags
390383

@@ -435,7 +428,7 @@ Authenticate to a registered organization in the Upbound Marketplace with the
435428
`--account` option, along with the username and password or token.
436429

437430
For example,
438-
`crossplane xpkg login --account=Upbound --username=my-user --password -`.
431+
`crossplane xpkg login --account=Upbound --username=my-user --password -`. -->
439432

440433
### xpkg logout
441434

@@ -451,8 +444,7 @@ Using `crossplane xpkg logout` removes the `session` from the
451444

452445
Push a Crossplane package file to a package registry.
453446

454-
The Crossplane CLI pushes images to the
455-
[Upbound Marketplace](https://marketplace.upbound.io/) at `xpkg.upbound.io` by
447+
The Crossplane CLI pushes images to the [crossplane-contrib](https://github.com/orgs/crossplane-contrib/packages) GitHub Container Registry at `xpkg.crossplane.io` by
456448
default.
457449

458450
{{< hint "note" >}}
@@ -504,13 +496,13 @@ already installed in Crossplane.
504496

505497
`crossplane xpkg update <package-kind> <registry package name and tag> [<optional-name>]`
506498

507-
The package file must be an organization, image and tag on the `xpkg.upbound.io`
508-
registry on [Upbound Marketplace](https://marketplace.upbound.io/).
499+
The package file must be an organization, image and tag on the `xpkg.crossplane.io`
500+
GitHub Container Registry in [crossplane-contrib](https://github.com/orgs/crossplane-contrib/packages) GitHub org.
509501

510502
For example, to update to the latest version of the
511-
[AWS S3 provider](https://marketplace.upbound.io/providers/upbound/provider-aws-s3/):
503+
[AWS S3 provider](https://github.com/crossplane-contrib/provider-upjet-aws):
512504

513-
`crossplane xpkg update provider xpkg.upbound.io/upbound/provider-aws-s3:v1`
505+
`crossplane xpkg update provider xpkg.crossplane.io/crossplane-contrib/provider-aws-s3:v1.20.1`
514506

515507

516508
## beta
@@ -569,11 +561,11 @@ related pods.
569561

570562
```shell
571563
crossplane beta top
572-
TYPE NAMESPACE NAME CPU(cores) MEMORY
573-
crossplane default crossplane-f98f9ddfd-tnm46 4m 32Mi
574-
crossplane default crossplane-rbac-manager-74ff459b88-94p8p 4m 14Mi
575-
provider default provider-aws-s3-1f1a3fb08cbc-5c49d84447-sggrq 3m 108Mi
576-
provider default upbound-provider-family-aws-48b3b5ccf964-76c9686b6-bgg65 2m 89Mi
564+
TYPE NAMESPACE NAME CPU(cores) MEMORY
565+
crossplane default crossplane-f98f9ddfd-tnm46 4m 32Mi
566+
crossplane default crossplane-rbac-manager-74ff459b88-94p8p 4m 14Mi
567+
provider default provider-aws-s3-1f1a3fb08cbc-5c49d84447-sggrq 3m 108Mi
568+
provider default crossplane-contrib-provider-family-aws-48b3b5ccf964-76c9686b6-bgg65 2m 89Mi
577569
```
578570

579571
{{<hint "important" >}}
@@ -942,7 +934,7 @@ To clear the cache and download the CRD files again use the `--clean-cache` flag
942934
To validate a managed resource against a provider,
943935
first, create a provider manifest file. For example, to validate an IAM role
944936
from Provider AWS, use the
945-
[Provider AWS IAM](https://marketplace.upbound.io/providers/upbound/provider-aws-iam/v1.0.0)
937+
[Provider AWS IAM](https://github.com/crossplane-contrib/provider-upjet-aws)
946938
manifest.
947939

948940
{{<hint "tip" >}}
@@ -957,7 +949,7 @@ kind: Provider
957949
metadata:
958950
name: provider-aws-iam
959951
spec:
960-
package: xpkg.upbound.io/upbound/provider-aws-iam:v1
952+
package: xpkg.crossplane.io/crossplane-contrib/provider-aws-iam:v1.20.1
961953
```
962954

963955
Now include the XR or managed resource to validate.

content/master/concepts/compositions.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ kind: Function
134134
metadata:
135135
name: function-patch-and-transform
136136
spec:
137-
package: xpkg.upbound.io/crossplane-contrib/function-patch-and-transform:v0.1.4
137+
package: xpkg.crossplane.io/crossplane-contrib/function-patch-and-transform:v0.1.4
138138
```
139139

140140
{{< hint "tip" >}}
@@ -155,7 +155,7 @@ During the install a Function reports `INSTALLED` as `True` and `HEALTHY` as
155155
```shell {copy-lines="1"}
156156
kubectl get functions
157157
NAME INSTALLED HEALTHY PACKAGE AGE
158-
function-patch-and-transform True Unknown xpkg.upbound.io/crossplane-contrib/function-patch-and-transform:v0.1.4 10s
158+
function-patch-and-transform True Unknown xpkg.crossplane.io/crossplane-contrib/function-patch-and-transform:v0.1.4 10s
159159
```
160160

161161
After the Function install completes and it's ready for use the `HEALTHY` status
@@ -545,7 +545,7 @@ kind: Function
545545
metadata:
546546
name: function-patch-and-transform
547547
spec:
548-
package: xpkg.upbound.io/crossplane-contrib/function-patch-and-transform:v0.1.4
548+
package: xpkg.crossplane.io/crossplane-contrib/function-patch-and-transform:v0.1.4
549549
```
550550
{{</expand>}}
551551

@@ -576,7 +576,7 @@ metadata:
576576
annotations:
577577
render.crossplane.io/runtime: Development
578578
spec:
579-
package: xpkg.upbound.io/crossplane-contrib/function-patch-and-transform:v0.1.4
579+
package: xpkg.crossplane.io/crossplane-contrib/function-patch-and-transform:v0.1.4
580580
```
581581

582582
{{<hint "tip">}}

content/master/concepts/connection-details.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ All the following examples use the same set of Compositions,
4949
CompositeResourceDefinitions and Claims.
5050

5151
All examples rely on
52-
[Upbound provider-aws-iam](https://marketplace.upbound.io/providers/upbound/provider-aws-iam/)
52+
[provider-aws-iam](https://github.com/REPLACEME)
5353
to create resources.
5454

5555
{{<expand "Reference Composition" >}}

content/master/concepts/managed-resources.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,9 @@ external object inside the Provider an _external resource_.
1515
{{< /hint >}}
1616

1717
Examples of managed resources include:
18-
* Amazon AWS EC2 [`Instance`](https://marketplace.upbound.io/providers/upbound/provider-aws/latest/resources/ec2.aws.upbound.io/Instance/v1beta1)
19-
* Google Cloud GKE [`Cluster`](https://marketplace.upbound.io/providers/upbound/provider-gcp/latest/resources/container.gcp.upbound.io/Cluster/v1beta1)
20-
* Microsoft Azure PostgreSQL [`Database`](https://marketplace.upbound.io/providers/upbound/provider-azure/latest/resources/dbforpostgresql.azure.upbound.io/Database/v1beta1)
18+
* Amazon AWS EC2 `Instance` defined in [provider-upjet-aws](https://github.com/crossplane-contrib/provider-upjet-aws).
19+
* Google Cloud GKE `Cluster` defined in [provider-upjet-gcp](https://github.com/crossplane-contrib/provider-upjet-gcp).
20+
* Microsoft Azure PostgreSQL `Database` defined in [provider-upjet-azure](https://github.com/crossplane-contrib/provider-upjet-azure).
2121

2222
{{< hint "tip" >}}
2323

@@ -35,7 +35,7 @@ Provider also define the available settings of a managed resource.
3535
Each managed resource is a unique API endpoint with their own
3636
group, kind and version.
3737

38-
For example the [Upbound AWS Provider](https://marketplace.upbound.io/providers/upbound/provider-aws/latest/)
38+
For example the [AWS Provider](https://github.com/crossplane-contrib/provider-upjet-aws)
3939
defines the {{<hover label="gkv" line="2">}}Instance{{</hover>}} kind from the
4040
group {{<hover label="gkv" line="1">}}ec2.aws.upbound.io{{</hover>}}
4141

@@ -529,7 +529,7 @@ Crossplane stores these details in a Kubernetes Secret object specified by the
529529
`writeConnectionSecretToRef` values.
530530

531531
For example, when creating an AWS RDS database instance with the Crossplane
532-
[community AWS provider](https://marketplace.upbound.io/providers/crossplane-contrib/provider-aws/v0.40.0)
532+
[community AWS provider](https://github.com/crossplane-contrib/provider-aws)
533533
generates an endpoint, password, port and username data. The Provider saves
534534
these variables in the Kubernetes secret
535535
{{<hover label="secretname" line="9" >}}rds-secret{{</hover>}}, referenced by

content/master/concepts/packages.md

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -34,24 +34,23 @@ the {{<hover line="6" label="install">}}spec.package{{</hover>}} value to the
3434
location of the configuration package.
3535

3636
{{< hint "important" >}}
37-
Beginning with Crossplane version 1.15.0 Crossplane uses the Upbound Marketplace
38-
Crossplane package registry at `xpkg.upbound.io` by default for downloading and
37+
Beginning with Crossplane version 1.20.0 Crossplane uses the [crossplane-contrib](https://github.com/orgs/crossplane-contrib/packages) GitHub Container Registry at `xpkg.crossplane.io` by default for downloading and
3938
installing packages.
4039

4140
Specify the full domain name with the `package` or change the default Crossplane
4241
registry with the `--registry` flag on the [Crossplane pod]({{<ref "./pods">}})
4342
{{< /hint >}}
4443

4544
For example to install the
46-
[Upbound AWS reference platform](https://marketplace.upbound.io/configurations/upbound/platform-ref-aws/v0.6.0).
45+
[Getting Started Configuration](https://github.com/crossplane-contrib/configuration-getting-started),
4746

4847
```yaml {label="install"}
4948
apiVersion: pkg.crossplane.io/v1
5049
kind: Configuration
5150
metadata:
52-
name: platform-ref-aws
51+
name: configuration-getting-started
5352
spec:
54-
package: xpkg.upbound.io/upbound/platform-ref-aws:v0.6.0
53+
package: xpkg.crossplane.io/crossplane-contrib/configuration-getting-started:v0.0.1
5554
```
5655
5756
{{<hint "tip" >}}
@@ -64,7 +63,7 @@ kind: Configuration
6463
metadata:
6564
name: platform-ref-aws
6665
spec:
67-
package: xpkg.upbound.io/upbound/platform-ref-aws@sha256:a30ad655c7699218d9234285d838d85582f015d02f7f061f8486b28248fd7db7
66+
package: xpkg.crossplane.io/crossplane-contrib/platform-ref-aws@sha256:a30ad655c7699218d9234285d838d85582f015d02f7f061f8486b28248fd7db7
6867
```
6968
{{< /hint >}}
7069
@@ -80,14 +79,14 @@ Use the
8079
{{<hover label="helm" line="5" >}}--set configuration.packages{{</hover >}}
8180
argument with `helm install`.
8281

83-
For example, to install the Upbound AWS reference platform,
82+
For example, to install the Getting Started configuration,
8483

8584
```shell {label="helm"}
8685
helm install crossplane \
8786
crossplane-stable/crossplane \
8887
--namespace crossplane-system \
8988
--create-namespace \
90-
--set configuration.packages='{xpkg.upbound.io/upbound/platform-ref-aws:v0.6.0}'
89+
--set configuration.packages='{xpkg.crossplane.io/crossplane-contrib/configuration-getting-started:v0.0.1}'
9190
```
9291

9392
### Install offline
@@ -116,8 +115,8 @@ View the configuration revisions with
116115
```shell {label="rev",copy-lines="1"}
117116
kubectl get configurationrevisions
118117
NAME HEALTHY REVISION IMAGE STATE DEP-FOUND DEP-INSTALLED AGE
119-
platform-ref-aws-1735d56cd88d True 2 xpkg.upbound.io/upbound/platform-ref-aws:v0.5.0 Active 2 2 46s
120-
platform-ref-aws-3ac761211893 True 1 xpkg.upbound.io/upbound/platform-ref-aws:v0.4.1 Inactive 5m13s
118+
platform-ref-aws-1735d56cd88d True 2 xpkg.crossplane.io/crossplane-contrib/platform-ref-aws:v0.5.0 Active 2 2 46s
119+
platform-ref-aws-3ac761211893 True 1 xpkg.crossplane.io/crossplane-contrib/platform-ref-aws:v0.4.1 Inactive 5m13s
121120
```
122121

123122
Only a single revision is active at a time. The active revision determines the
@@ -350,7 +349,7 @@ A working configuration reports `Installed` and `Healthy` as `True`.
350349
```shell {label="verify",copy-lines="1"}
351350
kubectl get configuration
352351
NAME INSTALLED HEALTHY PACKAGE AGE
353-
platform-ref-aws True True xpkg.upbound.io/upbound/platform-ref-aws:v0.6.0 54s
352+
platform-ref-aws True True xpkg.crossplane.io/crossplane-contrib/configuration-getting-started:v0.0.1 54s
354353
```
355354

356355
### Manage dependencies
@@ -361,13 +360,13 @@ Functions, Providers or other Configurations.
361360
If Crossplane can't meet the dependencies of a Configuration the Configuration
362361
reports `HEALTHY` as `False`.
363362

364-
For example, this installation of the Upbound AWS reference platform is
363+
For example, this installation of the Getting Started Configuration is
365364
`HEALTHY: False`.
366365

367366
```shell {copy-lines="1"}
368367
kubectl get configuration
369368
NAME INSTALLED HEALTHY PACKAGE AGE
370-
platform-ref-aws True False xpkg.upbound.io/upbound/platform-ref-aws:v0.6.0 71s
369+
platform-ref-aws True False xpkg.crossplane.io/crossplane-contrib/configuration-getting-started:v0.0.1 71s
371370
```
372371

373372
To see more information on why the Configuration isn't `HEALTHY` use
@@ -381,7 +380,7 @@ Kind: ConfigurationRevision
381380
# Removed for brevity
382381
Spec:
383382
Desired State: Active
384-
Image: xpkg.upbound.io/upbound/platform-ref-aws:v0.6.0
383+
Image: xpkg.crossplane.io/crossplane-contrib/configuration-getting-started:v0.0.1
385384
Revision: 1
386385
Status:
387386
Conditions:
@@ -467,7 +466,7 @@ spec:
467466
dependsOn:
468467
- apiVersion: pkg.crossplane.io/v1
469468
kind: Provider
470-
package: xpkg.upbound.io/crossplane-contrib/provider-aws
469+
package: xpkg.crossplane.io/crossplane-contrib/provider-aws
471470
version: ">=v0.36.0"
472471
crossplane:
473472
version: ">=v1.12.1-0"

0 commit comments

Comments
 (0)