Hospedagem do Kubernetes
O Kubernetes é uma opção popular para hospedar os aplicativos do Orleans. O Orleans será executado no Kubernetes sem uma configuração específica. No entanto, ele também pode aproveitar o conhecimento adicional que a plataforma de hospedagem pode oferecer.
O pacote Microsoft.Orleans.Hosting.Kubernetes
adiciona integração para hospedar um aplicativo do Orleans em um cluster do Kubernetes. O pacote fornece um método de extensão, UseKubernetesHosting, que executa as seguintes ações:
- SiloOptions.SiloName é definido como o nome do pod.
- EndpointOptions.AdvertisedIPAddress é definido como o IP do pod.
- EndpointOptions.SiloListeningEndpoint e EndpointOptions.GatewayListeningEndpoint são configurados para escutar em qualquer endereço, com o SiloPort e GatewayPort. Os valores de porta padrão de
11111
e30000
serão usados se nenhum valor for definido explicitamente). - ClusterOptions.ServiceId é definido como o valor do rótulo do pod com o nome
orleans/serviceId
. - ClusterOptions.ClusterId é definido como o valor do rótulo do pod com o nome
orleans/clusterId
. - No início do processo de inicialização, o silo investigará o Kubernetes para descobrir quais silos não têm pods correspondentes e marcarão esses silos como inativos.
- O mesmo processo ocorrerá no runtime para um subconjunto de todos os silos, para remover a carga no servidor de API do Kubernetes. Por padrão, dois silos no cluster observarão o Kubernetes.
Observe que o pacote de hospedagem do Kubernetes não usa o Kubernetes para clustering. Para clustering, ainda é necessário um provedor de clustering separado. Para obter mais informações sobre como configurar clusters, confira a documentação de Configuração do servidor.
Essa funcionalidade impõe alguns requisitos sobre como o serviço é implantado:
- Os nomes de silo devem corresponder aos nomes de pod.
- Os pods devem ter um rótulo
orleans/serviceId
eorleans/clusterId
que correspondam aoServiceId
eClusterId
do silo. O método mencionado acima propagará esses rótulos para as opções correspondentes no Orleans a partir das variáveis de ambiente. - Os pods devem ter as seguintes variáveis de ambiente definidas:
POD_NAME
,POD_NAMESPACE
,POD_IP
,ORLEANS_SERVICE_ID
,ORLEANS_CLUSTER_ID
.
O exemplo a seguir mostra como configurar corretamente esses rótulos e variáveis de ambiente:
apiVersion: apps/v1
kind: Deployment
metadata:
name: dictionary-app
labels:
orleans/serviceId: dictionary-app
spec:
selector:
matchLabels:
orleans/serviceId: dictionary-app
replicas: 3
template:
metadata:
labels:
# This label is used to identify the service to Orleans
orleans/serviceId: dictionary-app
# This label is used to identify an instance of a cluster to Orleans.
# Typically, this will be the same value as the previous label, or any
# fixed value.
# In cases where you are not using rolling deployments (for example,
# blue/green deployments),
# this value can allow for distinct clusters which do not communicate
# directly with each others,
# but which still share the same storage and other resources.
orleans/clusterId: dictionary-app
spec:
containers:
- name: main
image: my-registry.azurecr.io/my-image
imagePullPolicy: Always
ports:
# Define the ports which Orleans uses
- containerPort: 11111
- containerPort: 30000
env:
# The Azure Storage connection string for clustering is injected as an
# environment variable
# It must be created separately using a command such as:
# > kubectl create secret generic az-storage-acct `
# --from-file=key=./az-storage-acct.txt
- name: STORAGE_CONNECTION_STRING
valueFrom:
secretKeyRef:
name: az-storage-acct
key: key
# Configure settings to let Orleans know which cluster it belongs to
# and which pod it is running in
- name: ORLEANS_SERVICE_ID
valueFrom:
fieldRef:
fieldPath: metadata.labels['orleans/serviceId']
- name: ORLEANS_CLUSTER_ID
valueFrom:
fieldRef:
fieldPath: metadata.labels['orleans/clusterId']
- name: POD_NAMESPACE
valueFrom:
fieldRef:
fieldPath: metadata.namespace
- name: POD_NAME
valueFrom:
fieldRef:
fieldPath: metadata.name
- name: POD_IP
valueFrom:
fieldRef:
fieldPath: status.podIP
- name: DOTNET_SHUTDOWNTIMEOUTSECONDS
value: "120"
request:
# Set resource requests
terminationGracePeriodSeconds: 180
imagePullSecrets:
- name: my-image-pull-secret
minReadySeconds: 60
strategy:
rollingUpdate:
maxUnavailable: 0
maxSurge: 1
Para clusters habilitados para RBAC, a conta de serviço do Kubernetes dos pods também pode precisar do acesso obrigatório:
kind: Role
apiVersion: rbac.authorization.k8s.io/v1
metadata:
name: orleans-hosting
rules:
- apiGroups: [ "" ]
resources: ["pods"]
verbs: ["get", "watch", "list", "delete"]
---
kind: RoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
name: orleans-hosting-binding
subjects:
- kind: ServiceAccount
name: default
apiGroup: ''
roleRef:
kind: Role
name: orleans-hosting
apiGroup: ''
Investigações de atividade, preparação e inicialização
O Kubernetes pode investigar os pods para determinar a integridade de um serviço. Para obter mais informações, confira Configurar as investigações de atividade, preparação e inicialização na documentação do Kubernetes.
O Orleans usa um protocolo de associação de cluster para detectar e recuperar-se rapidamente das falhas de um processo ou de uma rede. Cada nó monitora um subconjunto de outros nós, enviando investigações periódicas. Se um nó não responder a várias investigações sucessivas de vários outros nós, será removido à força do cluster. Quando um nó com falha descobre que foi removido, ele termina imediatamente. O Kubernetes reiniciará o processo terminado e tentará voltar ao cluster.
As investigações do Kubernetes podem ajudar a determinar se um processo em um pod está em execução e não está paralisado em um estado de zumbi. as investigações não verificam a conectividade ou a capacidade de resposta entre pods nem executam verificações de funcionalidade no nível do aplicativo. Se um pod não responder a uma investigação de atividade, o Kubernetes poderá terminar eventualmente esse pod e reagendá-lo. Portanto, as investigações do Kubernetes e as investigações do Orleans são complementares.
A abordagem recomendada é configurar Investigações de Atividade no Kubernetes, as quais executam uma verificação simples e somente local para ver se o aplicativo está sendo executado conforme o esperado. Essas investigações servem para terminar o processo, se houver um congelamento total, por exemplo, devido a uma falha de runtime ou outro evento improvável.
Cotas de recursos
O Kubernetes funciona em conjunto com o sistema operacional, para implementar cotas de recursos. Isso permite que as reservas de CPU e memória e/ou os limites sejam impostos. Para um aplicativo primário que atende à carga interativa, recomendamos não implementar limites restritivos, a menos que necessário. É importante observar que as solicitações e os limites têm um significado consideravelmente diferente, bem como o local em que são implementados. Antes de definir solicitações ou limites, reserve um tempo para obter uma compreensão detalhada de como eles são implementados e impostos. Por exemplo, pode não haver uma medição uniforme da memória entre o Kubernetes, o kernel do Linux e o sistema de monitoramento. As cotas de CPU podem não ser impostas da maneira esperada.
Solução de problemas
Falha nos pods com reclamação de KUBERNETES_SERVICE_HOST and KUBERNETES_SERVICE_PORT must be defined
Mensagem de exceção completa:
Unhandled exception. k8s.Exceptions.KubeConfigException: unable to load in-cluster configuration, KUBERNETES_SERVICE_HOST and KUBERNETES_SERVICE_PORT must be defined
at k8s.KubernetesClientConfiguration.InClusterConfig()
- Verifique se as variáveis de ambiente e
KUBERNETES_SERVICE_HOST
deKUBERNETES_SERVICE_PORT
foram definidas dentro do pod. Você pode verificar executando o seguinte comandokubectl exec -it <pod_name> /bin/bash -c env
. - Defina
automountServiceAccountToken
como true nodeployment.yaml
do Kubernetes. Para obter mais informações, confira Configurar contas de serviço para pods
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de