kubernetes 本地搭建推荐(如何在Kubernetes上配置)

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(1)

作者 | Sudip Sengupta

译者 | 火火酱,责编 | Carol

封图 | CSDN 下载自视觉中国

在本文中,我们将一起完成在Kubernetes上配置Jenkins的工作。作为一款被广泛使用的开源CI服务器,Jenkins提供了数百个插件,能够为我们项目的构建、部署和自动化提供有力支持。

接下来,我们将:

1.使用minikube创建一个Kubernetes集群(这步不是必须的,如果你已经有Kubernetes集群了的话,可以跳过这一步)。

2.为Jenkins创建命名空间和持久卷。

3.使用Helm安装Jenkins。

4.设置并运行pipeline,对一个简单的web应用程序进行测试。

先决条件

1.Docker。有关安装Docker的详细信息,请参阅下方“Docker安装”页面。

https://docs.docker.com/get-docker/

2.Kubernetes集群。如果没有运行中的Kubernetes集群的话,请参阅章节“使用minikube创建kubernetes集群”

3.HelmCLI。可以按照下方链接中的步骤安装Helm CLI。

https://helm.sh/docs/intro/install/?ref=hackernoon.com

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(2)

用minikube创建一个Kubernetes集群(可选)

Minikube是一款在计算机上创建单节点Kubernetes集群的工具。如果没有Kubernetes集群的话,可以按照以下步骤进行创建:

1. 安装minikube :请参照下方“ Install minikube”页面中的步骤进行安装。https://kubernetes.io/docs/tasks/tools/install-minikube/?ref=hackernoon.com

2. 安装kubectl:请参照下方“Install and Set Up kubectl ”页面中的步骤进行安装。

https://kubernetes.io/docs/tasks/tools/install-kubectl/?ref=hackernoon.com

3. 然后就可以输入以下命令,创建minikube集群

minikube startminikube v1.5.2 on Darwin 10.15.2Automatically selected the 'hyperkit' driver (alternates: [virtualbox])Creating hyperkit VM (CPUs=2, Memory=2000MB, Disk=20000MB) ...Preparing Kubernetes v1.16.2 on Docker '18.09.9' ...Pulling images ...Launching Kubernetes ...Waiting for: apiserverDone! kubectl is now configured to use "minikube"

4. 创建完集群后,可以输入以下代码来验证其状态:

minikube status

如果一切顺利的话,应该会看到:

host: Runningkubelet: Runningapiserver: Runningkubeconfig: Configured

我们还可以通过使用内置的Kubernetes用户界面来了解集群概况:运行以下命令:

minikube dashboardVerifying dashboard health ...Launching proxy ...Verifying proxy health ...Opening http://127.0.0.1:56993/api/v1/namespaces/kubernetes-dashboard/services/http:kubernetes-dashboard:/proxy/ in your default browser...

打开的网页中包含了Kubernetes集群的状态信息:

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(3)

我们还可以使用仪表盘(dashboard)与Kubernetes集群进行交互。但是,这就有点超纲了。如果想要了解更多如何使用Kubernetes仪表盘创建或修改Kubernetes资源的信息,可以看看下方“ Web UI (Dashboard)”链接。

https://kubernetes.io/docs/tasks/access-application-cluster/web-ui-dashboard/?ref=hackernoon.com

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(4)

为Jenkins做好准备

按照以下步骤设置Jenkins:

  • 创建一个命名空间,从而在Kubernetes集群中将Jenkins与其他部署分离开。

  • 创建Persistentvolume以存储Jenkins数据,方便我们在重新启动时保留数据。

按照以下步骤为Jenkins设置好部署环境:

1. 运行以下命令,创建一个名为jenkins-namespace.yaml的文件:

apiVersion: v1kind: Namespacemetadata:name: jenkins

2. 输入以下命令以规范应用:

kubectl apply -f jenkins-namespace.yamlnamespace/jenkins created

3. 将以下代码粘贴到jenkins-volume.yaml文件中:

apiVersion: v1kind: PersistentVolumemetadata:name: jenkins-pvnamespace: jenkinsspec:storageClassName: jenkins-pvaccessModes:- ReadWriteOncecapacity:storage: 10GipersistentVolumeReclaimPolicy: RetainhostPath:path: /data/jenkins-volume/

4.输入以下命令以规范应用:

kubectl apply -f jenkins.volume.yaml

需要注意的是,hostPath使用节点/data/jenkins-volume/来模拟附属网络存储。这种方法只适合于开发和测试阶段。在生产阶段,需要提供网络资源(如Google Compute Engine持久盘,或Amazon Elastic Block Store卷)。

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(5)

安装Jenkins

Jenkins部署通常由一个主节点和一个或多个代理节点(可选)组成。Jenkins是一个依赖于多个组件的复杂应用程序,我们可以通过Helm来简化Jenkins部署。

(Helm:https://helm.sh/?ref=hackernoon.com)

Helm是Kubernetes的一个包管理器,其打包格式被称为chart。在GitHub上能够找到许多社区开发的chart。

(GitHub:https://github.com/helm/charts?ref=hackernoon.com)

1. 创建一个覆盖文件,并将其作为实参传给Helm CLI。将 https://raw.githubusercontent.com/kubernetes/charts/master/stable/jenkins/values.yaml中的内容粘贴到values.yaml文件中。

然后在你喜欢的文本编辑器中打开values.yaml文件,将以下行:

storageClass:

修改为:

storageClass: jenkins-pv

2. 现在,我们可以通过运行helm install命令来安装Jenkins,并传递以下参数:

helm install jenkins -f values.yaml stable/jenkins --namespace jenkins

会得到类似以下输出:

NAME: jenkins

LAST DEPLOYED: Mon Dec 30 17:26:08 2019

NAMESPACE: jenkins

STATUS: deployed

REVISION: 1

NOTES:

1. Get your 'admin' user password by running:

printf $(kubectl get secret --namespace jenkins jenkins -o jsonpath="{.data.jenkins-admin-password}" | base64 --decode);echo

2. Get the Jenkins URL to visit by running these commands in the same shell:

export Pod_NAME=$(kubectl get pods --namespace jenkins -l "app.kubernetes.io/component=jenkins-master" -l "app.kubernetes.io/instance=jenkins" -o jsonpath="{.items[0].metadata.name}")

echo http://127.0.0.1:8080

kubectl --namespace jenkins port-forward $POD_NAME 8080:8080

3. Login with the password from step 1 and the username: admin

3. 根据你环境的不同,Jenkins可能需要一定时间才能完成初始化,输入以下命令来检查Pod状态:

kubectl get pods --namespace=jenkins

Jenkins安装后,状态应像以下输出这样为Running:

❯ kubectl get pods --namespace=jenkins

NAME READY STATUS RESTARTS AGE

jenkins-645fbf58d6-6xfvj 1/1 Running 0 2m

4. 需要通过以下命令检索密码,才可以访问Jenkins服务器:

printf $(kubectl get secret --namespace jenkins jenkins -o jsonpath="{.data.jenkins-admin-password}" | base64 --decode);echo

Um1kJLOWQY

注意,你的密码应该是不一样的。

5. 使用以下命令来获取运行Jenkins的Pod名称:

export POD_NAME=$(kubectl get pods --namespace jenkins -l "app.kubernetes.io/component=jenkins-master" -l "app.kubernetes.io/instance=jenkins" -o jsonpath="{.items[0].metadata.name}")

这将创建名为POD_NAME的环境变量,将其值设置为运行Jenkins的Pod名称。

6. 使用kubectl命令设置端口转发:

kubectl --namespace jenkins port-forward $POD_NAME 8080:8080

Forwarding from 127.0.0.1:8080 -> 8080

Forwarding from [::1]:8080 -> 8080

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(6)

添加executor

Jenkins将executor定义为“用于在节点上执行由Pipeline或Pipeline定义的工作槽。一个节点可以配置零个或多个Executor,与在该节点上能够执行的Project或Pipeline数量相对应。”

接下来,我们将向Jenkins节点添加executor。

1. 浏览器打开http://localhost:8080,使用用户名admin和之前检索到的密码进行登录。

2. 在左侧导航栏中,选择Jenkins -> Manage Jenkins -> Manage Node

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(7)

3. 选择“Master ”,然后单击“Configure”

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(8)

4. 在 # of executors 输入框中输入“1”,然后单击“Save ”

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(9)

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(10)

安装并配置Node.js插件

在本教程中,我们将使用Node.js插件来部署并测试一个用Express.js编写的简单web应用程序。

按照以下步骤安装Node.js插件:

1. 左侧导航栏Jenkins -> Manage Manage Jenkins -> Manage Plugins -> Available Plugins,选择NodeJS 插件,然后单击“Install without restart”

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(11)

2. 安装完成后,会出现以下界面:

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(12)

3. 左侧导航栏Jenkins -> Manage Jenkins -> Global Tool Configuration,选择Add NodeJS。输入NodeJS安装名称,然后选择一个NodeJS版本,选好后单击“Save ”。

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(13)

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(14)

HelloWorld 存储库

为了展示Jenkins 的工作原理,我们创建了一个监听端口3000并输出“Hello World!”的简单Express.js 服务器。然后我们编写了一个单元测试,检查该web 应用程序是否能够按预期工作。同时,我们还更新了package.json 文件,以便Jenkins 可以通过npm test命令执行单元测试。

最后,我们用以下命令创建了一个Jenkinsfile:

pipeline {

agent any

tools {nodejs "node"}

stages {

stage('Cloning Git') {

steps {

git 'https://github.com/andreipope/HelloWorld'

}

}

stage('Install dependencies') {

steps {

sh 'npm install'

}

}

stage('Test') {

steps {

sh 'npm test'

}

}

}

}

以上构建了一个三阶段CD pipeline:

  • 首先,克隆了HelloWorld Git存储库

  • 然后,通过运行npm install 安装了依赖项

  • 最后,执行了单元测试

接下来,我们将配置Jenkins以运行该脚本。

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(15)

创建并运行Pipeline

Pipeline为交付软件提供了可重复且一致的流程。借助Jenkins,我们可以用Groovy编程语言将pipeline作为DSL脚本来编写。

按照以下步骤创建和运行pipeline:

1. 选择Jenkins -> New Item,然后输入pipeline名称(HelloWorld),完成后单击“OK”。

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(16)

2. 下一页,选择“Pipeline script from SCM”,并将Repository URL 设置为“https://github.com/andreipope/HelloWorld”。这是一个公共存储库,所以我们不需要配置任何证书凭证。

Jenkins会自动检索位于存储库根目录中的Jenkinsfile。

3. 现在,我们可以手动运行pipeline了:

kubernetes 本地搭建推荐(如何在Kubernetes上配置)(17)

4. 等它运行完后,应该会看到控制台输出类似内容:

npm test

> HelloWorld@1.0.0 test /var/jenkins_home/workspace/HelloWorld

> mocha

ExpressJS server

✓ Prints out Hello World (291ms)

1 passing (373ms)

[Pipeline] }

[Pipeline] // withEnv

[Pipeline] }

[Pipeline] // stage

[Pipeline] }

[Pipeline] // withEnv

[Pipeline] }

[Pipeline] // withEnv

[Pipeline] }

[Pipeline] // node

[Pipeline] End of Pipeline

Finished: SUCCESS

恭喜你!你已经成功在Kubernetes配置了Jenkins,并用它测试了一个简单的web应用程序。虽然看起来本文似乎包含了大量信息,但其实这只是Jenkins 和Kubernetes中最为浅显的内容。多尝试就会打开新世界!

,

免责声明:本文仅代表文章作者的个人观点,与本站无关。其原创性、真实性以及文中陈述文字和内容未经本站证实,对本文以及其中全部或者部分内容文字的真实性、完整性和原创性本站不作任何保证或承诺,请读者仅作参考,并自行核实相关内容。文章投诉邮箱:anhduc.ph@yahoo.com

    分享
    投诉
    首页