腾讯云部署Eclipse Che(云原生IDE)

2020-10-12 18:15:04 浏览数 (1)

准备工作

  • 已经创建了一个腾讯云容器服务集群
  • 配置好kubectl客户端
  • 已经有一个腾讯云(DNSPod)解析的域名

安装chectl

代码语言:txt复制
$ bash <(curl -sL  https://www.eclipse.org/che/chectl/)

安装NGINX Ingress Controller

详细安装过程见:https://kubernetes.github.io/ingress-nginx/deploy/

这里需要注意的是是controller使用的镜像地址国内无法访问,需要换成你自己的镜像地址,可以将镜像翻墙下载,然后上传到腾讯云容器服务的镜像仓库里。

安装cert-manager

cert-manager是原生的Kubernetes证书管理控制器。 它可以帮助从各种证书机构颁发证书,例如Let's Encrypt,HashiCorp Vault,Venafi,简单的签名密钥对或生成自签名证书。

它将确保证书有效并且是最新的,并在到期前尝试在配置的时间续订证书。

代码语言:txt复制
# Kubernetes 1.16 
$ kubectl apply --validate=false -f https://github.com/jetstack/cert-manager/releases/download/v1.0.2/cert-manager.yaml

# Kubernetes <1.16
$ kubectl apply --validate=false -f https://github.com/jetstack/cert-manager/releases/download/v1.0.2/cert-manager-legacy.yaml

本文只要确保会使用即可,有时间再详细介绍一下cert-manager

安装dnspod webhook

申请dnspod的api调用凭证

在安装dnspod webhook之前,需要新申请dnspod调用api接口的id和和token,首先登陆dnspod管理控制台(使用腾讯云账号即可登陆),如下图所示:

dnspodconsole.jpgdnspodconsole.jpg

进入“密钥管理”页面,点击“创建密钥”。

keymanager.jpgkeymanager.jpg

在创建“创建密钥”页面,输入密钥名称,点击“确定”即可。

createkey.jpgcreatekey.jpg

创建成功后,如下图所示:

createkeysuccess.jpgcreatekeysuccess.jpg

复制保存ID和Token、复制保存ID和Token、复制保存ID和Token,后面将用到。

安装dnspod webhook

下载代码:

代码语言:txt复制
$ git clone https://github.com/qqshfox/cert-manager-webhook-dnspod.git

使用helm安装:

代码语言:txt复制
$ cd cert-manager-webhook-dnspod
$ helm install --name cert-manager-webhook-dnspod ./deploy/cert-manager-webhook-dnspod 
    --namespace <NAMESPACE-WHICH-CERT-MANAGER-INSTALLED> 
    --set groupName=<GROUP_NAME> 
    --set secrets.apiID=<DNSPOD_API_ID>,secrets.apiToken=<DNSPOD_API_TOKEN> 
    --set clusterIssuer.enabled=true,clusterIssuer.email=<EMAIL_ADDRESS>

注意:上面的命令中中,namespace配置为che,GROUP_NAME建议使用acme.xxx.com这样的唯一标识即可,DNSPOD_API_ID和DNSPOD_API_TOKEN为上一步申请的api调用凭证,EMAIL_ADDRESS配置为您常用地址即可,在证书过期的时候会发送提醒之类到这个邮箱地址。

安装完后,webhook将自动帮您创建一个cluster issuer,如下所示:

代码语言:txt复制
[root@VM_0_10_centos cheworkspace]# kubectl get clusterissuer
NAME                                         READY   AGE
cert-manager-webhook-dnspod-cluster-issuer   True    14h

查看yaml格式,如下:

代码语言:txt复制
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  ……
  name: cert-manager-webhook-dnspod-cluster-issuer
  ……
spec:
  acme:
    email: zhcj11118@126.com
    preferredChain: ""
    privateKeySecretRef:
      name: cert-manager-webhook-dnspod-letsencrypt
    server: https://acme-v02.api.letsencrypt.org/directory
    solvers:
    - dns01:
        webhook:
          config:
            apiID: 184422
            apiTokenSecretRef:
              key: api-token
              name: cert-manager-webhook-dnspod-secret
          groupName: acme.venusource.com
          solverName: dnspod

申请ssl证书

eclipse che要求使用一个泛域名来自动配置相关的服务及实现多租户模式,我们需要解析一个*.xxx.xxx.cn这样的域名到nginx controller,所以cert-manager申请证书时,必须使用dns01方式认证域名所有权,HTTP方式不支持泛域名的所有权认证。请确保您在腾讯云申请了相关了域名。

新建文件che-certificate.yaml,内容如下:

代码语言:txt复制
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: che-certificate
  namespace: che
spec:
  dnsNames:
    - 'ide.gwunion.cn'
    - '*.ide.gwunion.cn'
  secretName: che-tls
  issuerRef:
    name: cert-manager-webhook-dnspod-cluster-issuer
    kind: ClusterIssuer

系统将调用letsencrypt的acme的接口为我们的域名申请证书。

注意:这里的secretName必须为che-tls,chectl在安装时会检查,如果有有che-tls这个secret就不在自动创建一个自签名的证书,直接使用che-tls。

执行下面的命令查看证书申请情况

代码语言:txt复制
kubectl describe Certificate che-certificate -n che

等待通过dns方式对域名进行所有权认证,一段1-2分钟内证书就申请完毕,并保存到名称为che-tls的secret内。

安装eclipse che

安装之前,请确保您使用的域名*.xxx.xxx.com已经解析到ingress nginx controller的IP地址,查看IP地址可执行下面的命令查看:

代码语言:txt复制
kubectl get services --namespace ingress-nginx

IP地址为EXTERNAL-IP字段,请在腾讯云域名解析控制台或dnspod域名解析控制台解析*.xxx.xxx.com的A记录到EXTERNAL-IP。

代码语言:txt复制
$ chectl server:start -a helm -b ide.gwunion.cn -p k8s --multiuser --k8spodreadytimeout=13000000 --k8spodwaittimeout=30000000
› Current Kubernetes context: 'cls-8437x8wt-context-default'
  ✔ Verify Kubernetes API...OK
  ✔ 


	

0 人点赞