자동 업데이트 사용

자동 업데이트를 사용으로 설정하면 ALB가 기본값으로 표시된 버전으로 업데이트됩니다. 새 버전이 기본 버전이 되면 ALB가 자동으로 해당 버전으로 업데이트됩니다.

클러스터의 구역에 하나의 작업자 노드만 존재하는 상태에서 ALB 복제본의 수를 1로 설정하는 경우 업데이트가 적용될 때마다 이 하나의 ALB 팟(Pod)이 삭제되고 새 팟(Pod)이 작성됩니다. 다른 존에 워커 노드와 ALB 복제본이 있더라도 이 프로세스로 인해 트래픽 중단이 발생할 수 있습니다. 트래픽 중단을 방지하려면 각 구역에 최소 두 개의 워커 노드가 존재하고, 각 ALB에 대해 두 개의 복제본이 존재하도록 해야 합니다. 업데이트 프로세스 중에 새 연결만 두 번째 ALB팟 (Pod) 으로 라우팅됩니다. 업데이트 ALB팟 (Pod) 의 기존 연결은 안전하게 종료됩니다. 업데이트 중에 종료된 기존 연결의 경우 클라이언트 애플리케이션에서 재시도를 시작하십시오.

자동 업데이트를 위한 유지보수 창 스케줄링

사용자 지정 자동화 작업( ConfigMap )을 생성하여 업데이트를 원하는 시간을 지정함으로써 자동 ALB 업데이트를 제어하고 관리할 수 있습니다.

자동 업데이트 시간을 설정하려면 배포 구성( ConfigMap )에서 ‘ updateStartTime ’ 및 ‘ updateEndTime ’ 키를 설정하면 됩니다. 각 키는 24시간 형식(HH:MM)으로 지정된 시간을 나타냅니다. 이 시간은 로컬 시간이 아닌 협정 세계시(UTC)로 지정됩니다.

1. configmap의 YAML 파일을 작성하십시오. data 필드에 updateStartTime 및 updateEndTime 필드를 키-값 쌍으로 지정하십시오.

   다음 예제 ConfigMap 는 자동 업데이트 기능을 설정하여, UTC 기준 20:34부터 23:59 사이에 클러스터 내 ALB 포드를 업데이트하도록 합니다.

   apiVersion: v1
   kind: ConfigMap
   metadata:
       name: ibm-ingress-deploy-config
       namespace: kube-system
   data:
       "updateStartTime": "20:34"
       "updateEndTime": "23:59"
   

2. 클러스터에 configmap을 배치하십시오. 새 규칙은 다음 번에 업데이트가 발생할 때 적용됩니다.

   kubectl apply -f <filename>.yaml
   

자동 업데이트 사용 안함

버그 수정 및 보안 업데이트를 수신하려면 자동 업데이트를 사용으로 유지하십시오. 자동 업데이트가 사용 안함으로 설정되면 사용자가 ALB를 수동으로 업데이트해야 합니다.

ibmcloud ks ingress alb autoupdate disable -c CLUSTER_NAME_OR_ID 를 실행하여 ALB에 대한 자동 업데이트를 사용 안함으로 설정할 수 있습니다.

클러스터에 대해 자동 업데이트가 사용으로 설정되어 있는지 확인하려면 ibmcloud ks ingress alb autoupdate get -c CLUSTER_NAME_OR_ID 명령을 사용하십시오. 자동 업데이트를 다시 사용하기로 결정한 경우 ibmcloud ks ingress alb autoupdate enable -c CLUSTER_NAME_OR_ID 를 실행할 수 있습니다.

수동 업데이트 적용

ibmcloud ks ingress alb update 명령을 사용하여 Ingress ALB팟 (Pod) 의 일회성 업데이트를 수동으로 적용할 수 있습니다. 이 명령은 기본 ALB 이미지 버전을 적용하지만 --version 옵션을 포함하여 다른 버전을 적용할 수 있습니다. 자세한 정보 또는 명령 옵션은 CLI 참조 를 참조하십시오.

--version 옵션을 사용하여 ALB 이미지를 특정 버전으로 업데이트하려면 자동 ALB 업데이트를 사용 안함으로 설정 한 후 지정된 버전을 실행하려는 기간 동안 사용 안함으로 설정된 상태로 유지해야 합니다. 자동 업데이트는 항상 기본 버전을 적용하고 사용자가 적용하는 모든 수동 업데이트를 겹쳐씁니다. 다른 버전을 사용하려는 경우 자동 업데이트를 사용으로 설정할 수 없습니다.

• 사용 가능한 ALB 버전을 확인하려면 다음 명령을 실행하십시오.

  ibmcloud ks ingress alb versions --region REGION
  

• 클러스터에서 모든 ALB 팟(Pod)을 업데이트하려면 다음 명령을 실행하십시오.

  ibmcloud ks ingress alb update -c CLUSTER_NAME_OR_ID --version IMAGE_VERSION
  

• 특정 ALB에 대한 ALB를 업데이트하려면 다음 명령을 실행하십시오.

  ibmcloud ks ingress alb update -c CLUSTER_NAME_OR_ID --version IMAGE_VERSION --alb ALB_ID [--alb ALB_2_ID ...]
  

지원되는 이미지 버전 보기

각 이미지 유형에 지원되는 세 개의 최신 버전을 나열하려면 다음 명령을 실행하십시오.

ibmcloud ks ingress alb versions

출력 예

Kubernetes Ingress versions
1.1.2_2507_iks (default)
1.2.1_2506_iks
0.35.0_1374_iks

Kubernetes Ingress 버전은 <community_version>_<ibm_build>_iks 형식을 따릅니다. IBM 빌드 번호는 IBM Cloud Kubernetes Service가 릴리스된 Kubernetes Ingress NGINX 릴리스의 가장 최신 빌드를 나타냅니다. 예를 들어, 1.1.2_2507_iks 버전은 0.47.0 Ingress NGINX 버전의 최신 빌드를 표시합니다. IBM Cloud Kubernetes Service에서는 취약성을 해결하기 위해 커뮤니티 이미지 버전의 빌드를 릴리스할 수 있습니다.

Ingress 이미지의 각 버전에 포함된 변경 사항에 대해서는 Ingress 버전 변경 내역을 참조하십시오.

이전 버전으로 되돌리기

ALB 포드가 최근에 업데이트되었지만, ALB에 대한 사용자 지정 구성이 최신 이미지 버전 빌드의 영향을 받는 경우, ibmcloud ks ingress alb update--version 옵션을 지정하여 ALB 포드를 이전의 지원되는 버전으로 롤백할 수 있습니다. ALB를 변경할 이미지 버전은 ibmcloud ks ingress alb versions 출력에 나열된 지원되는 이미지 버전이어야 합니다.

이전 버전으로 되돌리는 경우에는 자동 ALB 업데이트를 사용 안함으로 설정 한 후 이전 버전을 실행하려는 기간 동안 사용 안함으로 설정된 상태로 유지해야 합니다. 자동 업데이트는 항상 최신 버전을 적용하고 사용자가 적용하는 모든 수동 업데이트를 겹쳐씁니다. 이전 버전을 사용하려는 경우 자동 업데이트를 사용으로 설정할 수 없습니다.

구역에서 추가 ALB 작성

구역의 각 ALB는 서로 다른 작업자 노드에 두 개의 팟 (Pod) 으로 배치됩니다. ALB 처리 기능을 확장하고 추가 연결을 처리하기 위해 구역에서 추가 ALB를 작성할 수 있습니다. 새 ALB의 IP 주소가 Ingress 하위 도메인에 자동으로 추가됩니다.

다중 구역 클러스터를 작성하면, 작업자 노드가 있는 각 구역에 기본 공용 ALB가 작성됩니다. 나중에 이 초기 3개 영역 중 하나를 제거하고 다른 영역에 워커를 추가하더라도, 해당 새 영역에는 기본 공용 ALB가 생성되지 않습니다. ALB를 수동으로 작성하여 해당 새 구역에서 연결을 처리할 수 있습니다.

Ingress 리소스 유효성 검증을 사용할 때 모든 작성 및 업데이트 요청은 모든 ALB에 의해 유효성 검증됩니다. 특정 ALB 인스턴스에 대해 실행 중인 팟 (Pod) 이 없는 경우 클러스터에서 Ingress 리소스를 적용하지 못할 수 있습니다. 사용 상태의 각 ALB에 대해 하나 이상의 실행 중인 팟 (Pod) 이 있는지 확인하십시오. 자세한 정보는 Ingress 배치 사용자 정의 참조 를 참조하십시오.

1. 작업자 노드가 있는 각 구역에서 ALB를 작성하십시오.

   다음 명령은 클래식 클러스터에 적용됩니다. 자세한 정보 및 명령 옵션은 CLI 참조 를 참조하십시오.

   ibmcloud ks ingress alb create --cluster CLUSTER_NAME_OR_ID --type PUBLIC_OR_PRIVATE --zone ZONE --vlan VLAN_ID [--ip IP_ADDRESS] [--version image_version]
   

   다음 명령은 VPC 클러스터에 적용됩니다. 자세한 정보 및 명령 옵션은 CLI 참조 를 참조하십시오.

   ibmcloud ks ingress alb create vpc-gen2 --cluster CLUSTER_NAME_OR_ID --type PUBLIC_OR_PRIVATE --zone VPC_ZONE [--version image_version]
   

2. 각 구역에서 작성한 ALB의 상태 가 enabled 인지 확인하십시오. 클래식 클러스터의 경우 ALB IP 가 지정되었는지 확인하십시오. VPC 클러스터의 경우 로드 밸런서 호스트 이름 이 지정되었는지 확인하십시오.

   ibmcloud ks ingress alb ls --cluster CLUSTER_NAME_OR_ID
   

   일반적인 클러스터의 출력 예시.

   ALB ID                                            Enabled   Status     Type      ALB IP          Zone    Build                          ALB VLAN ID   NLB Version
   private-crdf253b6025d64944ab99ed63bb4567b6-alb1   false     disabled   private   -               dal12   ingress:1.1.2_2507_iks   2294021       -
   private-crdf253b6025d64944ab99ed63bb4567b6-alb2   false     disabled   private   -               dal10   ingress:1.1.2_2507_iks   2234947       -
   public-crdf253b6025d64944ab99ed63bb4567b6-alb1    true      enabled    public    169.48.228.78   dal12   ingress:1.1.2_2507_iks   2294019       -
   public-crdf253b6025d64944ab99ed63bb4567b6-alb2    true      enabled    public    169.46.17.6     dal10   ingress:1.1.2_2507_iks   2234945       -
   

   VPC 클러스터의 출력 예시.

   ALB ID                                            Enabled   Status     Type      Load Balancer Hostname                 Zone         Build
   private-crdf253b6025d64944ab99ed63bb4567b6-alb1   false     disabled   private   -                                      us-south-2   ingress:1.1.2_2507_iks
   private-crdf253b6025d64944ab99ed63bb4567b6-alb2   false     disabled   private   -                                      us-south-1   ingress:1.1.2_2507_iks
   public-crdf253b6025d64944ab99ed63bb4567b6-alb1    true      enabled    public    23f2dfb1-us-south.lb.appdomain.cloud   us-south-2   ingress:1.1.2_2507_iks
   public-crdf253b6025d64944ab99ed63bb4567b6-alb2    true      enabled    public    23f2dfb1-us-south.lb.appdomain.cloud   us-south-1   ingress:1.1.2_2507_iks
   

ALB 포드 복제본 수 변경

기본적으로 각 ALB에는 두 개의 복제본이 있습니다. ALB팟 (Pod) 의 수를 수동으로 변경하거나 동적 자동 스케일링을 사용으로 설정하여 ALB 처리 기능을 사용자 정의할 수 있습니다.

단일 ALB팟 (Pod) 은 많은 양의 요청을 처리할 수 있습니다. 제한시간 초과, 느린 응답 또는 기타 과부하 신호가 발생하는 경우 백엔드 애플리케이션의 상태를 확인하십시오. ALB팟 (Pod) 을 스케일링하기 전에 ALB가 애플리케이션의 병목 현상인지 확인하십시오. 그렇지 않으면 예상된 결과를 제공하지 않을 수 있습니다.

클래식 클러스터의 경우: ALB의 로드 밸런서 서비스 구성에서 externalTrafficPolicy 가 Local 로 설정된 경우 2개의 복제본을 초과하여 스케일링하지 마십시오. 클래식 로드 밸런서는 2개복제본의 고정 구성으로 실행되며 로드 밸런서 팟 (Pod) 과 동일한 노드에 있는 ALB팟 (Pod) 으로만 트래픽을 전달할 수 있습니다.

기본적으로 주기적인 Ingress 버전 업데이트가 자동으로 ALB로 롤아웃됩니다. 클러스터의 구역에 하나의 작업자 노드만 존재하는 상태에서 ALB 복제본의 수를 1로 설정하는 경우 업데이트가 적용될 때마다 이 하나의 ALB 팟(Pod)이 삭제되고 새 팟(Pod)이 작성됩니다. 이 프로세스로 인해 다른 구역에 작업자 노드 및 ALB 복제본이 존재하는 경우에도 트래픽 중단이 발생할 수 있습니다. 트래픽 중단을 방지하려면 각각의 구역에 두 개 이상의 작업자 노드가 존재하고 각각의 ALB에 대해 두 개의 복제본이 존재하는지 확인하십시오. 업데이트 프로세스 중에 새 연결만 두 번째 ALB팟 (Pod) 으로 라우팅됩니다. 업데이트 ALB팟 (Pod) 의 기존 연결은 안전하게 종료됩니다. 클라이언트 애플리케이션은 업데이트 중에 종료되는 기존 연결에 대해 재시도를 시작하는 것이 좋습니다.

ConfigMap을 작성하여 ALB 복제본의 수를 수동으로 변경하십시오. 동적 스케일링을 사용하도록 ALB를 구성 한 경우에는 ALB 복제본을 수동으로 스케일링할 수 없습니다.

1. ALB에 대한 ID를 가져오십시오.

   ibmcloud ks ingress alb ls -c CLUSTER_NAME_OR_ID
   

2. ibm-ingress-deploy-config configmap에 대한 YAML 파일을 작성하십시오. ALB마다 '{"replicas":<number_of_replicas>}'을(를) 추가하십시오. 이 예제는 ALB팟 (Pod) 의 수를 4개의 복제본으로 늘립니다.

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: ibm-ingress-deploy-config
     namespace: kube-system
   data:
     <alb1-id>: '{"replicas":4}'
     <alb2-id>: '{"replicas":4}'
     ...
   

3. 클러스터에서 ibm-ingress-deploy-config configmap을 작성하십시오.

   kubectl create -f ibm-ingress-deploy-config.yaml
   

4. 변경 사항을 적용하려면 ALB를 업데이트하십시오. 변경 사항이 반영되는 데 최대 5분 정도 걸릴 수 있으니 유의해 주세요.

   ibmcloud ks ingress alb update -c CLUSTER_NAME_OR_ID
   

5. Ready 로 설정된 ALB 포드의 수가 지정한 복제본 수만큼 증가했는지 확인하십시오.

   kubectl get pods -n kube-system | grep alb
   

동적 ALB 자동 스케일링을 구성하기 위한 예제 명령

평균 CPU 이용률 60%를 기반으로 하는 동적 스케일링에 대한 예제 명령입니다.

ibmcloud ks ingress alb autoscale set -c CLUSTER_NAME_OR_ID --alb ALB_ID --min-replicas 2 --max-replicas 5 --cpu-average-utilization 60

my-custom-metrics.yaml 파일에 저장된 사용자 정의 메트릭을 기반으로 하는 동적 스케일링에 대한 예제 명령입니다.

ibmcloud ks ingress alb autoscale set -c CLUSTER_NAME_OR_ID --alb ALB_ID --min-replicas 2 --max-replicas 5 --custom-metrics-file my-custom-metrics.yaml

평균 CPU 활용도 계산

다음 이미지는 자동 스케일링 구성을 계획할 때 CPU 사용량을 판별하기 위한 예제 시나리오를 보여줍니다.

수신 트래픽이 없는 두 개의 실행 중인 ALB 복제본이 있는 유휴 클러스터가 있다고 가정합니다. 이 경우 총 CPU 요청은 2*20m=40m 입니다. 복제본 중 하나는 5m CPU및 다른 7m CPU를 사용할 수 있습니다. 다음 공식을 사용하여 CPU 활용도를 계산할 수 있습니다.

ALB 자동 스케일링 사용 안함

ALB에 대한 자동 스케일링을 사용 안함으로 설정하는 명령을 실행하십시오.

ibmcloud ks ingress alb autoscale unset --alb ALB --cluster CLUSTER