Instalando um Cluster com o Instalador Assistido

Instale um cluster do OpenShift Container Platform no OCI usando o Instalador Assistido da Red Hat.

Antes de começar, verifique a seção Pré-requisitos desta documentação. O workflow do Assisted Installer envolve três etapas principais:

Gerando a imagem ISO de descoberta (Console do Red Hat).
Provisionando a infraestrutura de cluster (Console do OCI).
Concluindo a instalação (Red Hat Console).

Parte 1: Gerando o Arquivo ISO de Descoberta (Console do Red Hat)

Os nós de computação do cluster requerem uma imagem ISO de descoberta pré-configurada para validar configurações de hardware e rede durante a implantação do cluster. Siga as etapas em Usando o Instalador Assistido para gerar uma imagem ISO de descoberta compatível com o OCI (documentação da Red Hat) para gerar e fazer download do ISO de descoberta usando o Console do Red Hat Hybrid Cloud. Em seguida, retorne a este guia para Parte 2: Provisionando a Infraestrutura (Console do OCI)

Parte 2: Provisionando a Infraestrutura (Console do OCI)

Faça upload do ISO de descoberta e configure a infraestrutura usando o plug-in Red Hat OpenShift e o Resource Manager na Console do OCI.

Nas tarefas desta seção, você trabalha na Console do OCI para fazer upload da imagem ISO de descoberta e provisionar os recursos de infraestrutura do cluster conforme discutido em Arquivos de Configuração. Consulte Recursos Definidos pelo Terraform para OpenShift para obter uma lista dos recursos criados pelo script do Terraform usado para esse método de instalação. Observe que você especifica um compartimento existente e um bucket do Object Storage para o cluster. Consulte Criando um Compartimento e Criando um Bucket do Serviço Object Storage se precisar de instruções para criar esses recursos.

Fazendo Upload da Imagem ISO do Red Hat para o Object Storage

Na Console do OCI, crie um bucket do Object Storage e faça upload do ISO de descoberta para o bucket.
Localize o ISO de descoberta carregado e execute as seguintes etapas:
1. Crie uma solicitação pré-autenticada para o ISO no Object Storage.
2. Copie o URL gerado para usar como o URI da Origem da Imagem OpenShift na próxima etapa. Para obter mais informações, consulte Solicitações Pré-Autenticadas para o Serviço Object Storage.

Criando a Infraestrutura do Container Platform OpenShift

Siga as etapas para configurar a infraestrutura necessária para o cluster OpenShift.

Observação

Execute a pilha create-resource-attribution-tags antes de executar a pilha create-cluster para evitar falha de instalação.
A pilha create-resource-attribution-tags só precisa ser executada uma vez. Se o namespace de tag e as tags definidas já existirem, você poderá ignorar esta etapa para instalações futuras.

Abra o menu de navegação e selecione Serviços ao Desenvolvedor. Em seguida, selecione Red Hat OpenShift.
Na página Informações da pilha, digite um Nome e uma Descrição opcionais.
- A versão mais recente da pilha do Terraform é submetida a upload automaticamente para você.
- Os campos Criar no compartimento e versão do Terraform são pré-preenchidos.
(Opcional) Na seção Tags, adicione tags para organizar os recursos.
1. Na lista drop-down Namespace de tag, selecione um namespace de tag relevante.
2. No campo Chave de tag, especifique uma chave de tag.
3. No campo Valor da tag, especifique um valor para a tag.
4. Selecione Adicionar tag.
Selecione Próximo.
Na página Configurar variáveis, revise e configure as variáveis necessárias para os recursos de infraestrutura que a pilha cria quando você executa o job Aplicar para este plano de execução.

Na seção OpenShift Configuração do Cluster, verifique e configure os seguintes campos:

OpenShift Configuração de Cluster


Campo	Descrição
OCID da Tenancy	O OCID da tenancy atual. Valor padrão: tenancy atual
Compartimento	O OCID do compartimento no qual você deseja criar o cluster OpenShift. Valor padrão: Compartimento atual
Nome do Cluster	O nome do cluster OpenShift. Observação: use o mesmo valor para o nome do cluster especificado na Console do Red Hat Hybrid Cloud e certifique-se de que ele seja compatível com DNS.
Método de Instalação	O método de instalação que você deseja usar para instalar o cluster. Valor padrão: Instalador Assistido
Criar Imagem e Instâncias OpenShift	Permite a criação de imagens e instâncias OpenShift. Valor padrão: Verdadeiro
OpenShift URI da Origem da Imagem	O URL da Solicitação pré-autenticada criado na tarefa anterior, Fazendo Upload da Imagem ISO do Red Hat para o Object Storage. Observação: esse campo só fica visível quando a caixa de seleção Criar Imagem e Instâncias OpenShift está marcada.

Na seção OpenShift Tags de Atribuição de Recursos, revise e configure o seguinte campo:

OpenShift Tags de Atribuição de Recurso


Campo	Descrição
Compartimento do Namespace de Tag para Tags de Atribuição de Recurso OpenShift	O compartimento de namespace de tag para tags de atribuição de recurso OpenShift. Observação: Verifique se a tag especificada existe antes de aplicar a pilha do Terraform. O compartimento no qual o namespace de tag para tag de recurso é criado assume como padrão o compartimento atual. Para a Atribuição OpenShift nos recursos do OCI, o namespace de tag e as tags definidas são definidos como `openshift-tags` e `openshift-resource`. Se o namespace openshift-tags já existir, certifique-se de que ele esteja definido e aplicado corretamente. Por exemplo: `defined-tags" - {"openshift-tags"- {"openshift-resource" - "openshift-resource-infra"} }`

Na seção Configuração do Nó do Plano de Controle, revise e configure os seguintes campos:

Configuração do Nó do Plano de Controle

Observação: Esta seção só fica visível quando a caixa de seleção OpenShift Image Source URI está marcada.


Campo	Descrição
Forma do Plano de Controle	A forma da instância de computação dos nós do plano de controle. Para obter mais informações, consulte Formas de Computação. Valor padrão: VM.Standard.E5. Flexível
Contagem de Nós do Plano de Controle	O número de nós do plano de controle no cluster. Valor padrão: 3
OCPU do Nó do Plano de Controle	O número de OCPUs disponíveis em cada forma de nó do plano de controle. Valor padrão: 4
Memória do Nó do Plano de Controle	A quantidade de memória disponível, em gigabytes (GB), para cada forma de nó do plano de controle. Valor padrão: 24
Volume de Inicialização do Nó do Plano de Controle	O tamanho do volume de inicialização (GB), de cada nó do plano de controle. Valor padrão: 1024
VPU do Nó do Plano de Controle	O número de Unidades de Desempenho de Volume (VPUs) aplicadas ao volume, por 1 GB, de cada nó do plano de controle. Valor padrão: 100
Distribuir Instâncias do Plano de Controle entre ADs	Permite a distribuição automática de instâncias do plano de controle entre domínios de Disponibilidade (ADs) em uma sequência de reinício, a partir do AD selecionado. Se não for selecionada, todos os nós serão criados no AD inicial selecionado. Valor padrão: Verdadeiro
(Opcional) Iniciando o AD	Domínio de disponibilidade (AD) usado para posicionamento inicial do nó. Os nós adicionais são distribuídos automaticamente entre ADs em uma sequência de repetição alternada, começando com o AD selecionado.
Distribuir Instâncias do Plano de Controle entre FDs	Distribui instâncias do plano de controle entre Domínios de Falha em uma sequência de reinício. Se não for selecionada, o serviço OCI Compute os distribuirá com base na disponibilidade da forma e em outros critérios. Valor padrão: Verdadeiro

Na seção Configuração do Nó de Computação, revise e configure os seguintes campos:

Configuração do Nó de Computação

Observação: Esta seção só fica visível quando a caixa de seleção OpenShift Image Source URI está marcada.


Campo	Descrição
Forma de Computação	A forma da instância dos nós de computação. Para obter mais informações, consulte Formas de Computação. Valor padrão: VM.Standard.E5. Flexível
Contagem de Nós de Computação	O número de nós de computação no cluster. Valor padrão: 3
OCPU do Nó de Computação	O número de OCPUs disponíveis em cada forma de nó de computação. Valor padrão: 6
Memória do Nó de Computação	A quantidade de memória disponível, em gigabytes (GB), para cada forma de nó do plano de controle. Valor padrão: 16
Volume de Inicialização do Nó de Computação	O tamanho do volume de inicialização (GB) de cada nó do plano de controle. Valor padrão: 100
VPU do Nó do Serviço Compute	O número de VPUs (Unidades de Desempenho de Volume) aplicadas ao volume, por 1 GB, de cada nó de computação. Valor padrão: 30
Distribuir Instâncias de Computação entre ADs	Permite a distribuição automática de instâncias de computação entre domínios de Disponibilidade (ADs) em uma sequência de reinício, começando pelo AD selecionado. Se não for selecionada, todos os nós serão criados no AD inicial selecionado. Valor padrão: Verdadeiro
(Opcional) Iniciando o AD	Domínio de disponibilidade (AD) usado para posicionamento inicial do nó. Os nós adicionais são distribuídos automaticamente entre ADs em uma sequência de repetição alternada, começando com o AD selecionado.
Distribuir Instâncias de Computação entre FDs	Distribui instâncias de computação entre Domínios de Falha em uma sequência de reinício. Se não for selecionada, o serviço OCI Compute os distribuirá com base na disponibilidade da forma e em outros critérios. Valor padrão: Verdadeiro

Na seção Configuração de rede, revise e configure os seguintes campos:

Configuração de Rede


Campo	Descrição
Criar DNS Público	Crie uma zona de DNS pública com base no domínio Base especificado no campo DNS de Zona. Observação: se você não quiser criar um DNS público, crie uma zona de DNS privada, a menos que use sua própria solução de DNS. Para resolver nomes de host de cluster sem DNS, adicione entradas a `/etc/hosts` que mapeiem nomes de host de cluster para o endereço IP do Balanceador de Carga `api_apps` usando a saída `etc_hosts_entry` . Valor padrão: Verdadeiro
Criar DNS Privado	Cria uma zona de DNS privada com base no domínio Base, especificado no campo DNS da Zona, para suportar a resolução de nome de host dentro da VCN. Observação: A zona DNS privada contém os mesmos registros da zona DNS pública. Se estiver usando um domínio Base não registrado, recomendamos criar uma zona de DNS privada; caso contrário, talvez você precise de métodos alternativos para resolver os nomes de host do cluster. Para obter mais informações, consulte DNS Privado.
Ativar Balanceador de Carga de API Pública	Cria um Balanceador de Carga para o ponto final da API OpenShift na sub-rede pública com um endereço IP público para acesso externo. Observação: se não for selecionada, o Balanceador de Carga será criado em uma sub-rede privada com acesso limitado dentro da VCN ou de redes privadas conectadas. Em ambientes on-premises (por exemplo, C3/PCA), os IPs públicos podem ser internos (RFC 1918). O acesso público é útil para gerenciamento remoto, automação e CI/CD. Entre em contato com o administrador da rede, se necessário.
Ativar Balanceador de Carga de Aplicativos Públicos	Cria um Balanceador de Carga para aplicativos OpenShift na sub-rede pública com um endereço IP público para acesso externo a cargas de trabalho. Observação: se não for selecionada, o Balanceador de Carga será criado em uma sub-rede privada, limitando o acesso dentro da VCN ou por meio de uma VPN/rede privada. O acesso público é útil para aplicativos voltados para a Internet, serviços ao cliente ou cargas de trabalho multitenant. Nas configurações on-premises (por exemplo, C3/PCA), os IPs públicos podem ser internos (RFC 1918). Entre em contato com sua equipe de rede para garantir a exposição adequada. Valor padrão: Verdadeiro
DNS de Zona	O domínio base dos registros de DNS do seu cluster (por exemplo, `devcluster.openshift.com`), que é usado para criar Zonas de DNS públicas ou privadas (ou ambas). Esse valor deve corresponder ao valor do domínio Base inserido no Console do Red Hat Hybrid Cloud durante a criação da imagem ISO.
Label de DNS para VCN	Um label DNS da VCN, usado com o hostname da VNIC e com o label DNS da sub-rede para formar um FQDN (Nome de Domínio Totalmente Qualificado) para cada VNIC dentro dessa sub-rede. (por exemplo, `bminstance1.subnet123.vcn1.oraclevcn.com`). Valor padrão: openshiftvcn
CIDR da VCN	Os blocos IPv4 CIDR para a VCN do seu Cluster OpenShift. Valor padrão: 10.0.0.0/16
CIDR da Sub-rede Pública	Os blocos IPv4 CIDR para a sub-rede pública do Cluster OpenShift. Valor padrão: 10.0.0.0/20
CIDR de Sub-rede Privada para OCP	Os blocos IPv4 CIDR para a sub-rede privada do Cluster OpenShift. Valor padrão: 10.0.16.0/20
CIDR de Sub-rede Privada Reservada para Bare Metal	Os blocos IPv4 CIDR para a sub-rede privada de Clusters Bare metal OpenShift. Valor padrão: 10.0.32.0/20
Largura de Banda Máxima do Balanceador de Carga	Largura de banda (Mbps) que decide a largura de banda máxima (entrada mais saída) que o Balanceador de Carga pode atingir. Os valores devem estar entre `minimumBandwidthInMbps` e 8000. Valor padrão: 500
Faixa Mínima do Balanceador de Carga com	Largura de banda (Mbps) que decide a largura de banda total pré-provisionada (entrada mais saída). Os valores devem estar entre 10 e `maximumBandwidthInMbps` Valor padrão: 10

(Opcional) Na seção Configurações Avançadas, revise e configure os seguintes campos:

Configurações Avançadas


Campo	Descrição
Versão do Driver CCM e CSI do OCI	A versão do OCI CCM e do driver CSI a ser implantada. Para obter mais informações, consulte a lista de versões de driver e o arquivo STORAGE.MD no GitHub. Valor padrão: v1.32.0
Usar Tags de Atribuição de Instância Existentes	Indica se deve reutilizar o namespace de tag de atribuição de instância existente e as tags definidas ao marcar recursos do OCI. Por padrão, um novo conjunto de recursos de tag de atribuição de instância é criado e destruído com o restante dos recursos do cluster. Se necessário, crie recursos de tag de atribuição de instância separadamente que possam ser reutilizados com a pilha do Terraform na página create-instance-role-tags no repositório GitHub do oci-openshift. Os recursos de tag de atribuição de instância existentes não são destruídos quando o cluster é excluído.
(Opcional) Nome do Namespace de Tag de Atribuição da Instância	O nome do namespace da tag de atribuição de instância a ser reutilizado. Observação: esse campo só estará visível quando a caixa de seleção Usar Tags de Atribuição de Instância Existentes estiver marcada. Valor padrão: openshift-{cluster_name}
OCID do Compartimento do Namespace de Tag de Atribuição da Instância	O compartimento que contém o namespace de tag de atribuição de instância existente. Observação: esse campo só estará visível quando a caixa de seleção Usar Tags de Atribuição de Instância Existentes estiver marcada. Valor padrão: Compartimento atual

Selecione Próximo.
Na página Revisar, revise as informações e variáveis da pilha.
Selecione Criar para criar a pilha. A Console redireciona para a página de detalhes das pilhas do Resource Manager da nova pilha.
Na página de detalhes da pilha, selecione Aplicar para criar um job de aplicação e provisionar a infraestrutura para o cluster. Depois de executar um job de aplicação, obtenha os detalhes do job para verificar seu status. Bem-sucedido (SUCCEEDED) indica que o job foi concluído.
O Que Há a Seguir? Após executar o job de aplicação da pilha, permaneça na seção Resource Manager da Console do OCI e execute as etapas em Obtendo os Manifestos Personalizados para Instalação.

Obtendo manifestos personalizados para instalação

Depois de provisionar a infraestrutura no Resource Manager, nas "Saídas" do job de pilha, obtenha o arquivo dynamic_custom_manifest. Esta saída contém todos os manifestos necessários, concatenados e pré-formatados com os valores de configuração para CCM e CSI.

Na página Pilhas do Resource Manager, selecione o nome da pilha para ver seus detalhes. Se a exibição em lista de jobs não for exibida, selecione Jobs na seção Recursos para ver a lista de jobs.
Selecione o job para a criação da pilha. A página Detalhes do job é exibida na Console.
Selecione Saídas na seção Recursos para ver a lista de saídas do job.
Para a saída dynamic_custom_manifest, selecione mostrar para exibir o conteúdo da saída.
Selecione copy para copiar o conteúdo da saída. Observação: recomendamos que você não selecione e copie manualmente o texto, pois isso pode causar problemas com o recuo quando você colar essa saída na etapa a seguir.
Usando um editor de texto ou código, salve a saída copiada em um novo arquivo manifest.yaml. Faça upload desse arquivo na etapa Manifesto Personalizado do processo de instalação descrito na Parte 3: Instalação do Cluster (Console do Red Hat).

Parte 3: Instalando o Cluster (Console do Red Hat)

Retorne ao Console do Red Hat Hybrid Cloud para concluir a criação do cluster usando o Instalador Assistido. Siga as etapas em Concluindo as etapas restantes do Assisted Installer (documentação da Red Hat). Isso inclui:

Designando atribuições ao plano de controle e às instâncias de computação em execução no OCI.
Revisando as definições de armazenamento de cluster e rede.
Fazendo upload do arquivo manifest.yaml criado na Parte 2: Provisionando a Infraestrutura (Console do OCI) na seção Manifesto Personalizado.
Iniciando a instalação do cluster.

Acessando a Console do Cluster

Após a conclusão da instalação, selecione Iniciar Console do OpenShift no Console do Red Hat Hybrid Cloud. Isso abre a console de gerenciamento do novo cluster. O URL do Console da Web para a console de cluster é exibido na página Andamento da instalação e pode ser marcado em um browser. Na console de gerenciamento de cluster, faça download do arquivo kubeconfig que você usa para acessar o cluster com a CLI OpenShift (oc) ou a CLI do Kubernetes (kubectl).

Documentação do Oracle Cloud Infrastructure