OpenShift Container Platform 3.11 implementeren in Azure

Van toepassing op: ✔️ Virtuele Linux-heavy_check_mark: Flexibele schaalsets

U kunt een van de volgende methoden gebruiken om OpenShift Container Platform 3.11 in Azure te implementeren:

• U kunt de benodigde onderdelen van de Azure-infrastructuur handmatig implementeren en vervolgens de OpenShift Container Platform-documentatie volgen.
• U kunt ook een bestaande Resource Manager die de implementatie van het OpenShift Container Platform-cluster vereenvoudigt.
• Een andere optie is om de Azure Marketplace gebruiken.

Voor alle opties is een Red Hat-abonnement vereist. Tijdens de implementatie wordt Red Hat Enterprise Linux-exemplaar geregistreerd bij het Red Hat-abonnement en gekoppeld aan de pool-id die de rechten voor OpenShift Container Platform bevat. Zorg ervoor dat u een geldige gebruikersnaam, wachtwoord en pool-id hebt voor Red Hat Subscription Manager (RHSM). U kunt een activeringssleutel, organisatie-id en pool-id gebruiken. U kunt deze informatie controleren door u aan te melden bij https://access.redhat.com .

Implementeren met behulp van de sjabloon OpenShift Container Platform Resource Manager 3.11

Privéclusters

Voor het implementeren van privé-OpenShift-clusters is meer vereist dan alleen het niet hebben van een openbaar IP-adres dat is gekoppeld aan de hoofd-load balancer (webconsole) of aan de load balancer infrastructuurrevisor (router). Een privécluster maakt doorgaans gebruik van een aangepaste DNS-server (niet de standaard-Azure DNS), een aangepaste domeinnaam (zoals contoso.com) en vooraf gedefinieerde virtuele netwerken. Voor privéclusters moet u uw virtuele netwerk vooraf configureren met alle juiste subnetten en DNS-serverinstellingen. Gebruik vervolgens existingMasterSubnetReference, existingInfraSubnetReference, existingCnsSubnetReference en existingNodeSubnetReference om het bestaande subnet op te geven voor gebruik door het cluster.

Als privémaster is geselecteerd (masterClusterType=private), moet er een statisch privé-IP-adres worden opgegeven voor masterPrivateClusterIp. Dit IP-adres wordt toegewezen aan de front-end van de hoofd-load balancer. Het IP-adres moet zich binnen de CIDR voor het hoofdsubnet en niet in gebruik zijn. masterClusterDnsType moet worden ingesteld op 'aangepast' en de DNS-hoofdnaam moet worden opgegeven voor masterClusterDns. De DNS-naam moet worden toegepast op het statische privé-IP-adres en wordt gebruikt voor toegang tot de console op de hoofdknooppunten.

Als privérouter is geselecteerd (routerClusterType=privé), moet een statisch privé-IP-adres worden opgegeven voor routerPrivateClusterIp. Dit IP-adres wordt toegewezen aan de front-end van de infrastructuur load balancer. Het IP-adres moet zich binnen de CIDR voor het infrastructuursubnet en niet in gebruik zijn. routingSubDomainType moet worden ingesteld op 'aangepast' en de DNS-naam met jokertekens voor routering moet worden opgegeven voor routingSubDomain.

Als privé-masters en privérouters zijn geselecteerd, moet de aangepaste domeinnaam ook worden ingevoerd voor domainName

Na een geslaagde implementatie is het Bastion-knooppunt het enige knooppunt met een openbaar IP-adres waar u SSH in kunt gebruiken. Zelfs als de hoofdknooppunten zijn geconfigureerd voor openbare toegang, worden ze niet blootgesteld voor SSH-toegang.

Als u wilt implementeren met behulp Resource Manager sjabloon, gebruikt u een parametersbestand om de invoerparameters op te geven. Als u de implementatie verder wilt aanpassen, vert u de GitHub en wijzigt u de juiste items.

Enkele algemene aanpassingsopties zijn onder andere, maar zijn niet beperkt tot:

• Bastion-VM-grootte (variabele in azuredeploy.json)
• Naamconventeiten (variabelen in azuredeploy.json)
• Details van OpenShift-cluster, gewijzigd via hosts-bestand (deployOpenShift.sh)

Het parametersbestand configureren

De OpenShift Container Platform-sjabloon heeft meerdere vertakkingen die beschikbaar zijn voor verschillende versies van OpenShift Container Platform. Op basis van uw behoeften kunt u rechtstreeks vanuit de repo implementeren of u kunt de repo vervorken en aangepaste wijzigingen aanbrengen in de sjablonen of scripts voordat u implementeert.

Gebruik de appId waarde van de service-principal die u eerder hebt gemaakt voor de aadClientId parameter .

In het volgende voorbeeld ziet u een parametersbestand met de naam azuredeploy.parameters.json met alle vereiste invoer.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "_artifactsLocation": {
            "value": "https://raw.githubusercontent.com/Microsoft/openshift-container-platform/master"
        },
        "location": {
            "value": "eastus"
        },
        "masterVmSize": {
            "value": "Standard_E2s_v3"
        },
        "infraVmSize": {
            "value": "Standard_D4s_v3"
        },
        "nodeVmSize": {
            "value": "Standard_D4s_v3"
        },
        "cnsVmSize": {
            "value": "Standard_E4s_v3"
        },
        "osImageType": {
            "value": "defaultgallery"
        },
        "marketplaceOsImage": {
            "value": {
                "publisher": "RedHat",
                "offer": "RHEL",
                "sku": "7-RAW",
                "version": "latest"
            }
        },
        "storageKind": {
            "value": "changeme"
        },
        "openshiftClusterPrefix": {
            "value": "changeme"
        },
        "minorVersion": {
            "value": "69"
        },
        "masterInstanceCount": {
            "value": 3
        },
        "infraInstanceCount": {
            "value": 3
        },
        "nodeInstanceCount": {
            "value": 3
        },
        "cnsInstanceCount": {
            "value": 3
        },
        "osDiskSize": {
            "value": 64
        },
        "dataDiskSize": {
            "value": 64
        },
        "cnsGlusterDiskSize": {
            "value": 128
        },
        "adminUsername": {
            "value": "changeme"
        },
        "enableMetrics": {
            "value": "false"
        },
        "enableLogging": {
            "value": "false"
        },
        "enableCNS": {
            "value": "false"
        },
        "rhsmUsernameOrOrgId": {
            "value": "changeme"
        },
        "rhsmPoolId": {
            "value": "changeme"
        },
        "rhsmBrokerPoolId": {
            "value": "changeme"
        },
        "sshPublicKey": {
            "value": "GEN-SSH-PUB-KEY"
        },
        "keyVaultSubscriptionId": {
            "value": "255a325e-8276-4ada-af8f-33af5658eb34"
        },
        "keyVaultResourceGroup": {
            "value": "changeme"
        },
        "keyVaultName": {
            "value": "changeme"
        },
        "enableAzure": {
            "value": "true"
        },
        "aadClientId": {
            "value": "changeme"
        },
        "domainName": {
            "value": "contoso.com"
        },
        "masterClusterDnsType": {
            "value": "default"
        },
        "masterClusterDns": {
            "value": "console.contoso.com"
        },
        "routingSubDomainType": {
            "value": "nipio"
        },
        "routingSubDomain": {
            "value": "apps.contoso.com"
        },
        "virtualNetworkNewOrExisting": {
            "value": "new"
        },
        "virtualNetworkName": {
            "value": "changeme"
        },
        "addressPrefixes": {
            "value": "10.0.0.0/14"
        },
        "masterSubnetName": {
            "value": "changeme"
        },
        "masterSubnetPrefix": {
            "value": "10.1.0.0/16"
        },
        "infraSubnetName": {
            "value": "changeme"
        },
        "infraSubnetPrefix": {
            "value": "10.2.0.0/16"
        },
        "nodeSubnetName": {
            "value": "changeme"
        },
        "nodeSubnetPrefix": {
            "value": "10.3.0.0/16"
        },
        "existingMasterSubnetReference": {
            "value": "/subscriptions/abc686f6-963b-4e64-bff4-99dc369ab1cd/resourceGroups/vnetresourcegroup/providers/Microsoft.Network/virtualNetworks/openshiftvnet/subnets/mastersubnet"
        },
        "existingInfraSubnetReference": {
            "value": "/subscriptions/abc686f6-963b-4e64-bff4-99dc369ab1cd/resourceGroups/vnetresourcegroup/providers/Microsoft.Network/virtualNetworks/openshiftvnet/subnets/infrasubnet"
        },
        "existingCnsSubnetReference": {
            "value": "/subscriptions/abc686f6-963b-4e64-bff4-99dc369ab1cd/resourceGroups/vnetresourcegroup/providers/Microsoft.Network/virtualNetworks/openshiftvnet/subnets/cnssubnet"
        },
        "existingNodeSubnetReference": {
            "value": "/subscriptions/abc686f6-963b-4e64-bff4-99dc369ab1cd/resourceGroups/vnetresourcegroup/providers/Microsoft.Network/virtualNetworks/openshiftvnet/subnets/nodesubnet"
        },
        "masterClusterType": {
            "value": "public"
        },
        "masterPrivateClusterIp": {
            "value": "10.1.0.200"
        },
        "routerClusterType": {
            "value": "public"
        },
        "routerPrivateClusterIp": {
            "value": "10.2.0.200"
        },
        "routingCertType": {
            "value": "selfsigned"
        },
        "masterCertType": {
            "value": "selfsigned"
        }
    }
}

Vervang de parameters door uw specifieke informatie.

Verschillende releases kunnen verschillende parameters hebben, dus controleer de benodigde parameters voor de vertakking die u gebruikt.

azuredeploy. Uitleg van het bestand Parameters.json

Implementeren met behulp van Azure CLI

In het volgende voorbeeld worden het OpenShift-cluster en alle gerelateerde resources geïmplementeerd in een resourcegroep met de naam openshiftrg, met de implementatienaam myOpenShiftCluster. Er wordt rechtstreeks vanuit de GitHub verwezen naar de sjabloon en er wordt een lokaal parametersbestand met de naam azuredeploy.parameters.json gebruikt.

az deployment group create -g openshiftrg --name myOpenShiftCluster \
      --template-uri https://raw.githubusercontent.com/Microsoft/openshift-container-platform/master/azuredeploy.json \
      --parameters @./azuredeploy.parameters.json

De implementatie duurt ten minste 60 minuten, op basis van het totale aantal geïmplementeerde knooppunten en de geconfigureerde opties. De Bastion DNS FQDN en URL van de OpenShift-console worden naar de terminal afgedrukt wanneer de implementatie is voltooien.

{
  "Bastion DNS FQDN": "bastiondns4hawllzaavu6g.eastus.cloudapp.azure.com",
  "OpenShift Console URL": "http://openshiftlb.eastus.cloudapp.azure.com/console"
}

Als u de opdrachtregel niet wilt vastbinden totdat de implementatie is voltooid, voegt u toe als een van de opties --no-wait voor de groepsimplementatie. De uitvoer van de implementatie kan worden opgehaald uit de Azure Portal in de implementatiesectie voor de resourcegroep.

Verbinding maken aan het OpenShift-cluster

Wanneer de implementatie is uitgevoerd, haalt u de verbinding op uit de uitvoersectie van de implementatie. Verbinding maken naar de OpenShift-console met uw browser met behulp van de URL van de OpenShift-console. U kunt ook via SSH naar de Bastion-host gaan. Hier volgt een voorbeeld waarin de gebruikersnaam van de beheerder clusteradmin is en de FQDN van het openbare IP-ADRES van bastion bastiondns4hawllzaavu6g.eastus.cloudapp.azure.com:

$ ssh clusteradmin@bastiondns4hawllzaavu6g.eastus.cloudapp.azure.com

Resources opschonen

Gebruik de opdracht az group delete om de resourcegroep, het OpenShift-cluster en alle gerelateerde resources te verwijderen wanneer ze niet meer nodig zijn.

az group delete --name openshiftrg

Volgende stappen

• Taken na implementatie
• Problemen met De implementatie van OpenShift in Azure oplossen
• Aan de slag met OpenShift Container Platform