构建形式
Kubernetes的构建形式能够分为3种,别离是本地环境构建、容器环境构建、Bazel环境构建。
Kubernetes构建形式:
- 本地环境构建
1) make
2) make all - 容器环境构建
1) make release
2) make quick-release - Bazel环境构建
1) make bazel-build
上面将具体介绍前两种构建形式:
本地环境构建
执行make或者make all命令,会编译Kubernetes的所有组件,组件二进制文件输入的相对路径是_output/bin。如果咱们须要对Makefile的执行过程进行调试,能够在make命令前面加-n参数,输入但不执行所有执行命令,这样能够展现更具体的编译构建过程。假如咱们想独自构建某个组价,如kubectl组件,则须要指定WHAT参数。命令示例如下:
make WHAT=cmd/kubectl
Makefile是一个十分自动化构建工具,能够用来构建和测试Go语言的应用程序,Makefile还实用于大多数编程语言,在Kubernetes的源码根目录中,有两个与Makefile相干的文件,性能别离如下:
- Makefile:顶层Makefile文件,形容了整个我的项目所有代码文件的编译程序、编译规定及编译后的二进制文件输入等。
- Makefile.generated_file:形容了代码生成的逻辑。
本地构建过程
通过调用hack/make-rules/build.sh脚本开始构建组件,传入要构建的组件名称,不指定组件名称则构建所有组件。hack/make-rules/build.sh代码示例如下:
kube::golang::build_binaries "$@"
build_binaries接管构建的组件名称,设置构建所须要的环境及一些编译时所需的Go flags选项,而后通过go install构建组件:
go install "${build_args[@]}" "$@"
在go install命令执行实现后,二进制输入的目录为_output/bin。
最初,能够应用make clean命令来清理构建环境。
容器环境构建
通过容器(Docker)进行Kubernetes构建也非常简单,Kubernetes提供了两种容器环境下得构建形式:make release 和make quick-release,它们之间的区别如下:
- make release:构建所有指标平台(Darwin、Linux、Windows),构建过程会比拟久,并同时执行单元测试过程。
- make quick-release:疾速构建,只构建以后平台,并略过单元测试过程。
Kubernetes容器环境构建流程:
构建环境的配置及验证:kube::build::verify_prereqs构建容器镜像:kube::build::build_image构建代码:kube::build::run_build_command make cross将文件从容器复制到主机:kube::build::copy_output打包:kube::release::package_tarballs
在容器环境构建过程中,有多个容器镜像参加其中,别离介绍如下:
- build 容器(kube-cross):即构建容器,在该容器中会对代码文件执行构建操作,实现后会被删除。
- data容器:即存储容器,用于寄存构建过程中所须要的的所有文件。
- raync容器:即同步容器:用于在容器和主机之间传输数据,实现后会被删除。
上面介绍一下Kubernetes容器环境构建过程。
1.kube::build::verfy_prereqs
进行构建环境的配置及验证。该过程会查看本机是否装置了Docker容器环境,对于Darwin平台,该过程会查看本机是否装置了docker-machine环境。
2.kube::build::build_image
依据Dockerfile文件构建容器镜像。Dockerfile文件来源于build/build-image/Dockerfile,代码示例如下:
代码门路:build/common.sh
function kube::build::build_image() { mkdir -p "${LOCAL_OUTPUT_BUILD_CONTEXT}" ... cp "${KUBE_ROOT}/build/build-image/Dockerfile" "${LOCAL_OUTPUT_BUILD_CONTEXT}/Dockerfile" cp "${KUBE_ROOT}/build/build-image/rsyncd.sh" "${LOCAL_OUTPUT_BUILD_CONTEXT}/" dd if=/dev/urandom bs=512 count=1 2>/dev/null | LC_ALL=C tr -dc 'A-Za-z0-9' | dd bs=32 count=1 2>/dev/null > "${LOCAL_OUTPUT_BUILD_CONTEXT}/rsyncd.password" chmod go= "${LOCAL_OUTPUT_BUILD_CONTEXT}/rsyncd.password" kube::build::update_dockerfile kube::build::set_proxy kube::build::docker_build "${KUBE_BUILD_IMAGE}" "${LOCAL_OUTPUT_BUILD_CONTEXT}" 'false' ... kube::build::ensure_data_container kube::build::sync_to_container}
构建容器镜像的流程如下:
- 通过mkdir命令创立构建镜像的文件夹(即_output/images/...)。
- 通过cp命令复制构建镜像所需的相干文件,如Dockerfile文件和rsyncd同步脚本等。
- 通过kube::build::docker_build函数,构建容器镜像。
- 通过kube::build::ensure_data_container函数,运行存储容器并挂载Volume。
- 通过kube::build::sync_to_container函数,运行同步容器并挂载存储容器的Volume,而后通过rsnyc命令同步Kubernetes源码到存储容器的Volume。
3.kube::build::run_build_command make cross
此时,容器构建环境曾经筹备好,上面开始运行构建容器并在构建容器外部执行构建Kubernetes源码的操作,代码示例如下:
代码门路:build/common.sh
function kube::build::run_build_command_ex() { ... local detach=false ... "${docker_cmd[@]}" "${cmd[@]}" if [[ "${detach}" == false ]]; then kube::build::destroy_container "${container_name}" fi}
在执行kube::build::run_build_command_ex函数中,通过${docker_cmd[@]}""${cmd[@]}
命令执行构建操作(即在容器内执行make cross 命令)。容器内的构建过程与本地环境下的构建过程雷同。其中构建平台有KUBE_SUPPORTED_SERVER_PLATFORMS变量管制,代码示例如下:
代码门路:hack/lib/golang.sh
readonly KUBE_SUPPORTED_SERVER_PLATFORMS=( linux/amd64 linux/arm linux/arm64 linux/s390x linux/ppc64le)
构建的组件由KUBE_SERVER_TARGETS变量管制,代码示例如下:
代码门路:hack/lib/golang.sh
kube::golang::server_targets() { local targets=( cmd/kube-proxy cmd/kube-apiserver cmd/kube-controller-manager cmd/kubelet cmd/kubeadm cmd/kube-scheduler vendor/k8s.io/kube-aggregator vendor/k8s.io/apiextensions-apiserver cluster/gce/gci/mounter ) echo "${targets[@]}"}IFS=" " read -ra KUBE_SERVER_TARGETS <<< "$(kube::golang::server_targets)"
4.kube::build::copy_output
应用同步容器,将编译后的代码文件复制到主机上。
5.kube::release::package_tarballs
进行打包,将二进制文件打包到_output目录中。
最终,代码文件以tar.gz压缩包的模式输入至_output/release-tars文件夹。