Add a quickstart for AlibabaCloud Provider with Crossplane

[xiaozhu36]

No description provided.

[netlify]

❌ Deploy Preview for crossplane failed. Why did it fail? →

Name	Link
🔨 Latest commit	e802952
🔍 Latest deploy log	https://app.netlify.com/projects/crossplane/deploys/683434fae2a5d6000864e696

[netlify]

❌ Deploy Preview for crossplane failed. Why did it fail? →

Name	Link
🔨 Latest commit
🔍 Latest deploy log	https://app.netlify.com/projects/crossplane/deploys/68499ae0caf0819b0d6540e5

[jbw976]

Thanks for making this contribution and continuing to support your provider @xiaozhu36! that's great to see this continued effort and commitment 😉

Let's fix this error to get the changes deploying to the preview site where they will be easier to review in their rendered form.

[jbw976]

looks like there is an error on this line causing the build/deployment to the preview site to fail:

11:33:27 AM: Error: error building site: assemble: "/opt/build/repo/content/master/getting-started/provider-alibabacloud-part-2.md:25:1": failed to extract shortcode: shortcode "expand" must be closed or self-closed

This section of the contributing guide should help: https://docs.crossplane.io/contribute/features/#hide-long-outputs

[xiaozhu36]

Thanks for your feedback. I have fixed it.

[humoflife]

Looks good.

Nit: would be excellent to also show how to set up OIDC in addition to static credentials.

[humoflife]

It would be excellent if we could also show an example for OIDC setup with AlibabaCloud.

[jbw976]

to keep these consistent and streamlined in the quick starts, i'd recommend not bringing in OIDC into scope for this guide. That feels like advanced configuration that is better documented in the provider itself. These quick starts are intended to get people going as easily as possible. For example, the AWS provider quick start uses static creds and just links out to the AWS documentation - that feels more appropriate for a quick start.

[jbw976]

All the checks seem to be stuck not running, even after I approved the workflows to run. I'm going to close this PR and re-open to try to get them unstuck 🙏

[jbw976]

It looks like the build of the docs site with these changes is still failing: https://app.netlify.com/projects/crossplane/deploys/68499ae0caf0819b0d6540e5

I can reproduce this locally too with hugo server as describe in the contributing guide:

❯ hugo server
Watching for changes in /Users/jared/dev/go/src/github.com/crossplane/docs/{content,package.json,postcss.config.js,static,themes}
Watching for config changes in /Users/jared/dev/go/src/github.com/crossplane/docs/config.yaml
Start building sites …
hugo v0.137.0-59c115813595cba1b1c0e70b867e734992648d1b+extended darwin/arm64 BuildDate=2024-11-04T16:04:06Z VendorInfo=gohugoio

Built in 216 ms
Error: error building site: process: readAndProcessContent: "/Users/jared/dev/go/src/github.com/crossplane/docs/content/master/getting-started/provider-alibabacloud.md:45:16": failed to extract shortcode: shortcode "hover" must be closed or self-closed

So it's another shortcode tag that isn't closed. Could you iterate on cleaning these up until you get a successful hugo server run? Thank you! 🙏

[haarchri]

@xiaozhu36 first off, thank you for the effort and time you put into this PR.

Since this PR was opened, the documentation has gone through significant updates as part of the Crossplane 2.0 refresh. Because of that, this PR is unfortunately now out of date, and the existing conflicts / issues haven't been resolved.

To keep the docs aligned with the current structure and content, we are going to close this PR for now.

That said, we would absolutely love to review this again if you would like to rework the changes against the latest version of the documentation. If you do, please make sure the content fits within the appropriate sections of the Crossplane v2 docs structure.

Thanks again for the contribution and the work you put into this 🙌