GameApp 说明-容器服务-文档中心-腾讯云

简介
组件介绍
该组件是基于游戏进程重启后保持共享内存的特性，自研的一种容器原地更新的 Kubernetes 工作负载（GameApp）控制器。
组件功能
支持原地更新，并保持共享内存（目前支持 image 更新）。
支持 GameApp Scale（HPA）特性。
支持 operator 高可用部署。
给重启的容器注入一次性元数据，可实现容器重启时控制是否清空共享内存的功能。
部署在集群内 Kubernetes 对象
Kubernetes 对象名称
类型
默认占用资源
所属 Namespaces
gameapps.game.scr.ied.com
CustomResourceDefinition
-
-
gameapp-operator
ClusterRoleBinding
-
-
gameapp-operator
ClusterRole
-
-
gameapp-operator
ServiceAccount
-
default
gameapp-controller-manager
StatefulSet
1C2G
default
限制条件
支持 Kubernetes 1.10 以上版本的集群。
需设置 kube-apiserver 的启动参数为： --feature-gates=CustomResourceSubresources=true。
说明
推荐您在 腾讯云容器服务 中购买 1.12.4 版本集群，无需修改任何参数，开箱可用。
使用方法
组件安装
1. 登录 容器服务控制台，在左侧导航栏中选择集群。
2. 在“集群管理”页面单击目标集群 ID，进入集群详情页。
3. 选择左侧菜单栏中的组件管理，进入 “组件列表” 页面。
4. 在“组件列表”页面中选择新建，并在“新建组件”页面中勾选 GameApp。
5. 单击完成即可创建组件。
Yaml 创建并使用 GameApp 工作负载
创建
1. 创建  GameApp  资源时，指定需注入的 env，并指定更新策略为原地更新。yaml 文件内容如下所示：
apiVersion: game.scr.ied.com/v1
kind: GameApp
metadata:
  name: "test-gameapp"
spec:
  replicas: $replicas
  selector:
 matchLabels:
   app: nginx
  serviceName: "test-gameapp"
  template:
 metadata:
   annotations:
     test: test
   labels:
     app: nginx
 spec:
   containers:
   - image: nginx
     name: c1
     ports:
     - containerPort: 80
       name: web
     resources: {}
     volumeMounts:
     - mountPath: /dev/shm
       name: shm
     env:
     - name: clearSHM
       valueFrom:
         fieldRef:
           # 指定需要注入的 env
           fieldPath: metadata.annotations['oneshot.cloud.tencent.com/clearSHM'] 
   terminationGracePeriodSeconds: 10
   volumes:
   - emptyDir:
       medium: Memory
       sizeLimit: 1Gi
     name: shm
  updateStrategy:
 type: StableUpdate # 指定策略为原地更新
使用
1. 执行以下命令，设置升级镜像和一次性参数。
$ cat example/patch.yaml
template:
  metadata:
 annotations:
   oneshot.cloud.tencent.com/clearSHM: "true"
  spec:
 containers:
 - image: nginx:1.14        
   name: c1
$ kubectl patch gameapp test-gameapp --patch "$(cat patch.yaml)"
2. 执行以下命令，验证 env 是否注入成功。
kubectl exec test-gameapp-1 printenv clearSHM
true
执行结果返回 步骤1 中所设置的参数，则说明 env 注入成功。
3. 执行以下命令，仅设置升级镜像。
kubectl patch gameapp test-gameapp --type=json -p'[{"op":"replace","path":"/spec/template/spec/containers/0/image","value":"nginx:1.14"}]'
4. 再次执行以下命令，查看是否无 env 注入。
kubectl exec test-gameapp-1 printenv clearSHM
无返回值，则说明无 env 注入。

Kubernetes 对象名称	类型	默认占用资源	所属 Namespaces
gameapps.game.scr.ied.com	CustomResourceDefinition	-	-
gameapp-operator	ClusterRoleBinding	-	-
gameapp-operator	ClusterRole	-	-
gameapp-operator	ServiceAccount	-	default
gameapp-controller-manager	StatefulSet	1C2G	default

GameApp 说明

本页目录：

简介

组件介绍

组件功能

部署在集群内 Kubernetes 对象

限制条件

使用方法

组件安装

Yaml 创建并使用 GameApp 工作负载

创建

使用