Skip to content

OSDOCS-3029: Added Azure Marketplace install content#48577

Merged
mjpytlak merged 1 commit intoopenshift:mainfrom
mjpytlak:osdocs-3029
Sep 15, 2022
Merged

OSDOCS-3029: Added Azure Marketplace install content#48577
mjpytlak merged 1 commit intoopenshift:mainfrom
mjpytlak:osdocs-3029

Conversation

@mjpytlak
Copy link
Contributor

@mjpytlak mjpytlak commented Jul 29, 2022

Version(s):
CP to 4.11 and 4.12

Issue:
This PR addresses osdocs-3029.

Link to docs preview:

@openshift-ci openshift-ci bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Jul 29, 2022
@mjpytlak mjpytlak force-pushed the osdocs-3029 branch 2 times, most recently from 23a64f3 to 8f64fd3 Compare July 29, 2022 17:24
@mjpytlak
Copy link
Contributor Author

@jeana-redhat Here is the Azure content. Wanted to give you a look at this ahead of our call next week.

@mjpytlak
Copy link
Contributor Author

mjpytlak commented Aug 4, 2022

@patrickdillon @MayXuQQ Ready for SME and QE review. PTAL.

CC: @dmesser @jeana-redhat

Copy link

@MayXuQQ MayXuQQ left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. suggest replace urn with version, then need not distinguish the command for EMEA
  2. sample missing azure

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

when "urn": "redhat-limited:rh-ocp-worker:rh-ocp-worker-gen1:4.8.2021122100",
$az vm image show --urn redhat-limited:rh-ocp-worker:rh-ocp-worker-gen1:<version>
how about directly use $ az vm image show --urn <urn>

then need not specify the EMEA in the following,
just notes EMEA publisher is redhat-limited

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@MayXuQQ I would prefer to leave the current NA/EMEA examples as is. It is the clearest way to specify that the commands do differ. And I am using <version> to keep the doc technically accurate when 4.8.2021122100 is no longer the only available version to select.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if you do no use urn,
need specify that the sku: 'rh-ocp-worker' and 'rh-ocp-worker-gen1', created VM generation is V2 or V1 ,
and more publisher redhat and redhat-limited (EMEA)
not just version different

$  az vm image list --all --offer rh-ocp-worker --publisher redhat -o table
Offer          Publisher       Sku                 Urn                                                             Version
-------------  --------------  ------------------  --------------------------------------------------------------  --------------
rh-ocp-worker  RedHat          rh-ocp-worker       RedHat:rh-ocp-worker:rh-ocp-worker:4.8.2021122100               4.8.2021122100
rh-ocp-worker  RedHat          rh-ocp-worker-gen1  RedHat:rh-ocp-worker:rh-ocp-worker-gen1:4.8.2021122100          4.8.2021122100
rh-ocp-worker  redhat-limited  rh-ocp-worker       redhat-limited:rh-ocp-worker:rh-ocp-worker:4.8.2021122100       4.8.2021122100
rh-ocp-worker  redhat-limited  rh-ocp-worker-gen1  redhat-limited:rh-ocp-worker:rh-ocp-worker-gen1:4.8.2021122100  4.8.2021122100

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I updated the conceptual material at the beginning of this section with your suggestions. Also - thank you for the example output. I have added it to the procedure. PTAL. Thank you.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

compute:
- architecture: amd64
  hyperthreading: Enabled
  name: worker
  platform:
    azure:
      type: Standard_D4s_v5      
      osImage:
        publisher: redhat
        offer: rh-ocp-worker
        sku: rh-ocp-worker
        version: 4.8.2021122100
  replicas: 3

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you. Good catch on the sample.

@mjpytlak mjpytlak force-pushed the osdocs-3029 branch 4 times, most recently from 0674f3f to 88758ef Compare August 9, 2022 19:15
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

your image has more white space ?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you. I removed the extra space. Not sure why this comment does not show the update, but the space has been removed and the published output looks good. [1]

Appreciate your feedback. Is there anything else or is the doc good to go?

[1] http://file.rdu.redhat.com/mpytlak/osdocs-3029/installing/installing_azure/installing-azure-customizations.html#installation-azure-marketplace-subscribe_installing-azure-customizations

@mjpytlak mjpytlak force-pushed the osdocs-3029 branch 2 times, most recently from cc8e2fe to 1f98062 Compare August 10, 2022 12:57
@MayXuQQ
Copy link

MayXuQQ commented Aug 10, 2022

/lgtm

@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Aug 10, 2022
@mjpytlak
Copy link
Contributor Author

@patrickdillon when you have a moment PTAL.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry to add a late change here, because I know this is due soon.

We should probably add a note/sentence somewhere to avoid potential confusion about versions (because the versioning here is confusing).

The output of this command shown in this table will have the correct version to be used. In this case it is 4.8.2021122100. What is potentially confusing to users is that the correct version here is going to be 4.8.x even though they could be installing 4.9, 4.10, or 4.11. We only distribute the 4.8 image, and it doesn't really matter because the VM image will be automatically updated to the latest image for their target version before the install completes.

So I think we probably need a note saying: even though you're installing 4.9(+) the correct image version to specify will be 4.8.x and your VMs will automatically be upgraded as part of the install.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That is an excellent catch @patrickdillon. My latest commit adds a note to step 1. Please let me know what you think.

@openshift-ci openshift-ci bot removed the lgtm Indicates that a PR is ready to be merged. label Aug 18, 2022
@mjpytlak
Copy link
Contributor Author

@MayXuQQ My latest commit adds a note to the first step of the procedure to clarify that regardless of the version you are installing, the correct version is 4.8.x

@MayXuQQ
Copy link

MayXuQQ commented Aug 19, 2022

/lgtm

@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Aug 19, 2022
@patrickdillon
Copy link
Contributor

/lgtm

Thanks mike!

Copy link
Contributor

@lpettyjo lpettyjo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see 4 commits for this PR. Please squash to one.

@openshift-ci openshift-ci bot removed the lgtm Indicates that a PR is ready to be merged. label Sep 13, 2022
@openshift-ci
Copy link

openshift-ci bot commented Sep 13, 2022

New changes are detected. LGTM label has been removed.

@mjpytlak
Copy link
Contributor Author

I see 4 commits for this PR. Please squash to one.

Thanks @lpettyjo. Squashed. Anything else or good to go?

@ocpdocs-previewbot
Copy link

🤖 Bots are busy building the preview. It will be available soon at:
https://48577--docspreview.netlify.app

Build log: https://circleci.com/gh/ocpdocs-previewbot/openshift-docs/333

Copy link
Contributor

@lpettyjo lpettyjo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Otherwise, LGTM!

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like the second row, last column value isn't flush with the column heading.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks. Fixed.

@mjpytlak mjpytlak added the peer-review-done Signifies that the peer review team has reviewed this PR label Sep 13, 2022
@mjpytlak mjpytlak merged commit 5a4868a into openshift:main Sep 15, 2022
@mjpytlak
Copy link
Contributor Author

/cherrypick enterprise-4.12

@mjpytlak
Copy link
Contributor Author

/cherrypick enterprise-4.11

@openshift-cherrypick-robot

@mjpytlak: new pull request created: #50460

Details

In response to this:

/cherrypick enterprise-4.12

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@openshift-cherrypick-robot

@mjpytlak: new pull request created: #50461

Details

In response to this:

/cherrypick enterprise-4.11

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

branch/enterprise-4.11 branch/enterprise-4.12 peer-review-done Signifies that the peer review team has reviewed this PR size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants