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

Resolving issue #2566 #423

Open
wants to merge 3 commits into
base: canary
Choose a base branch
from
Open

Resolving issue #2566 #423

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
03f16b8
Resolving issue 2566
ldabas-msft Oct 15, 2024
bb7ba0b
#2440 Issue fix
ldabas-msft Oct 15, 2024
63cc4ac
fixing minor indent issue
ldabas-msft Oct 16, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/azure_jumpstart_hcibox/AKS/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,22 +6,22 @@

## Azure Kubernetes Service on Azure Stack HCI

Azure Stack HCI can provide host infrastructure for [Azure Kubernetes Service clusters](https://learn.microsoft.com/azure-stack/aks-hci/). HCIBox comes pre-configured with Azure Kubernetes Service on HCI (AKS-HCI). To see this in action, navigate to the resource group where you deployed HCIBox and follow these steps.

Check failure on line 9 in docs/azure_jumpstart_hcibox/AKS/_index.md

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'HCIBox'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'HCIBox'?", "location": {"path": "docs/azure_jumpstart_hcibox/AKS/_index.md", "range": {"start": {"line": 9, "column": 140}}}, "severity": "ERROR"}

Check failure on line 9 in docs/azure_jumpstart_hcibox/AKS/_index.md

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'HCIBox'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'HCIBox'?", "location": {"path": "docs/azure_jumpstart_hcibox/AKS/_index.md", "range": {"start": {"line": 9, "column": 289}}}, "severity": "ERROR"}

## Explore AKS on Azure Stack HCI

HCIBox is preconfigured with a network subnet dedicated to AKS deployment. Subnet details are as follows:

Check failure on line 13 in docs/azure_jumpstart_hcibox/AKS/_index.md

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'HCIBox'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'HCIBox'?", "location": {"path": "docs/azure_jumpstart_hcibox/AKS/_index.md", "range": {"start": {"line": 13, "column": 1}}}, "severity": "ERROR"}

Check failure on line 13 in docs/azure_jumpstart_hcibox/AKS/_index.md

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'subnet' instead of 'Subnet'.

Raw Output:
{"message": "[Vale.Terms] Use 'subnet' instead of 'Subnet'.", "location": {"path": "docs/azure_jumpstart_hcibox/AKS/_index.md", "range": {"start": {"line": 13, "column": 76}}}, "severity": "ERROR"}

| Network details | |
| ---------- | --------------------- |
| Subnet | 10.10.0.0/24 |

Check failure on line 17 in docs/azure_jumpstart_hcibox/AKS/_index.md

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'subnet' instead of 'Subnet'.

Raw Output:
{"message": "[Vale.Terms] Use 'subnet' instead of 'Subnet'.", "location": {"path": "docs/azure_jumpstart_hcibox/AKS/_index.md", "range": {"start": {"line": 17, "column": 5}}}, "severity": "ERROR"}
| Gateway | 10.10.0.1 |
| VLAN Id | 110 |
| DNS Server | 192.168.1.254 |

Before creating an AKS workload cluster, you must create a local virtual network object. HCIBox includes a script that will complete this task using the pre-configured network. The script will then create a new AKS workload cluster.

Check failure on line 22 in docs/azure_jumpstart_hcibox/AKS/_index.md

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'HCIBox'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'HCIBox'?", "location": {"path": "docs/azure_jumpstart_hcibox/AKS/_index.md", "range": {"start": {"line": 22, "column": 90}}}, "severity": "ERROR"}

- Open your HCIBox resource group and click on the _jumpstart_ custom location resource, then click "Arc-enabled services." Here you should see the hybridaksextension service available on the cluster. This is installed by default on Azure Stack HCI clusters, and is required for creating AKS workload clusters on HCI.

Check failure on line 24 in docs/azure_jumpstart_hcibox/AKS/_index.md

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'HCIBox'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'HCIBox'?", "location": {"path": "docs/azure_jumpstart_hcibox/AKS/_index.md", "range": {"start": {"line": 24, "column": 13}}}, "severity": "ERROR"}

![Screenshot showing aks extension](./custom_location_resources.png)

Expand All @@ -37,7 +37,7 @@

![Screenshot showing edit with VSCode](./open_with_code.png)

- Uncomment line 6 in the script and edit the placeholder value for the _$aadgroupID_ parameter with the object ID of your Microsoft Entra group. Save the script and close VSCode when finished.

Check failure on line 40 in docs/azure_jumpstart_hcibox/AKS/_index.md

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'Uncomment'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'Uncomment'?", "location": {"path": "docs/azure_jumpstart_hcibox/AKS/_index.md", "range": {"start": {"line": 40, "column": 3}}}, "severity": "ERROR"}

![Screenshot showing editing script](./edit_script.png)

Expand All @@ -49,7 +49,7 @@

![Screenshot showing script running](./run_configure_aks.png)

- Once complete, you should have an AKS workload cluster called _hcibox-aks_ in your HCIBox resource group.

Check failure on line 52 in docs/azure_jumpstart_hcibox/AKS/_index.md

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'HCIBox'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'HCIBox'?", "location": {"path": "docs/azure_jumpstart_hcibox/AKS/_index.md", "range": {"start": {"line": 52, "column": 86}}}, "severity": "ERROR"}

![Screenshot showing AKS in resource group](./aks_in_resource_group.png)

Expand All @@ -62,6 +62,8 @@
> ```
> az extension update --name connectedk8s
> ```


- From Azure portal, open Cloud Shell and run the following command, using the name of your HCIBox resource group.

```
Expand Down
7 changes: 7 additions & 0 deletions docs/azure_jumpstart_hcibox/cloud_deployment/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,13 @@ Once your bicep deployment is complete with Azure CLI or Azure Developer CLI, yo

### Connecting to the HCIBox Client virtual machine

> **Note:** As the subnet the HCI VMs resides on is on the second nested layer, it is necessary to connect to the AzSMGMT machine to be able to connect to those VMs:
> The HCI VM subnet is also not routable into the Azure Virtual Network, hence it won't be possible to connect to virtual machines on the HCI cluster using Azure Bastion.
>
> If you are having difficulties connecting into a stack HCI vm:
Copy link
Contributor

Choose a reason for hiding this comment

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

"Stack HCI VM"

> You can run `mstsc /v:192.168.1.11` from HCIBox-Client to connect to the AzSMGMT nested VM.
> From there, run `mstsc /v:192.168.200.x` to connect to the HCI VMs (replace x with the IP of your deployed VM).

Various options are available to connect to _HCIBox-Client_ VM, depending on the parameters you supplied during deployment.

- [RDP](#connecting-directly-with-rdp) - available after configuring access to port 3389 on the _Arc-App-Client-NSG_, or by enabling [Just-in-Time access (JIT)](#connect-using-just-in-time-access-jit).
Expand Down
3 changes: 3 additions & 0 deletions docs/azure_jumpstart_hcibox/deployment_az/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,9 @@ Azure CLI can be used to deploy HCIBox into your Azure subscription. Azure CLI i

![Screenshot showing retrieving StackHCI resource provider id](./hci_rp_id.png)


> **Note:** Please avoid using the $ symbol in the `windowsAdminPassword`. Using this symbol can cause the LogonScript to fail.

- Edit the [main.parameters.json](https://github.com/microsoft/azure_arc/blob/main/azure_jumpstart_hcibox/bicep/main.parameters.json) template parameters file and supply some values for your environment.
- _`spnClientId`_ - Your Azure service principal id
- _`spnClientSecret`_ - Your Azure service principal secret
Expand Down
Loading