本文将向您介绍Chef生态系统,如何实现配置管理,以及有关系统合规性的全面基础知识。我们的主要服务对象是那些编码经验有待提升的初学读者。闲言少叙,让我们从最基本的术语开始介绍:
- Chef Cookbooks – Cookbooks(是Chef Code的组织方式。Cookbooks包含了许多非常重要的recipe、配置文件(profile)和子目录。它们定义了将各种应用于被管理系统的配置和合规性控制。
- Chef Server – Chef Infra Server(架构服务器)会存储Cookbook、配置文件、策略文件(policyfile)、以及其他Chef代码,并将它们分享给被管理的目标节点。也就是说,它既包括了那些已分配的cookbook和配置文件的系统的信息,又维护着与目标环境有关的信息搜索索引,因此您可以按需便捷地识别和管理系统中的各个离散子集。
- Chef Automate – 作为Chef的企业级平台,Chef Automate许开发人员、运营和安全工程师通过协作,交付出应用程序和基础架构的更改,以及合规性的状态。Chef Automate提供了横跨多个数据中心和云服务提供商的洞察力。它可以与Chef Infra Server和Habitat Builder一起被安装,以提供完整的Chef体验。您可以通过链接--https://www.youtube.com/watch?v=XlCyd_DH1YU,了解更多有关Automate的设置与运行。
- Chef Client – Chef Client是运行在诸如Linux、Windows或MacOS等管理系统上的代理。它通过与Chef Server通信,以提取策略文件或run_list所需的cookbook、合规性配置文件、以及相关配置,然后执行recipe和合规性的扫描,并将其结果报告发回Chef Server。
- Chef InSpec – 通过提供审计和合规性配置文件,Chef InSpec可用于测试您的Cookbook逻辑,并确保您的系统处于预期的状态。与Chef cookbook类似,其配置文件由Chef Client触发和应用,并通过CLI和Chef Automate仪表板返回输出的结果。那些被成功应用的配置文件,将显示系统是否合规。
- Chef Workstation – Chef Workstation包含了着手编写和使用Chef cookbook所需的一切。其中包括:用于与Chef Server通信的命令行实用程序,以及在更新环境之前,在本地验证cookbook的测试工具。它可以免费地安装在Linux、macOS和Windows系统上,并包含嵌入式的Ruby和其他开箱即用的依赖项。由于该“工具箱”包含了用于创建和构建Chef的所有内容,因此它取代了现已过时的ChefDK。
- Chef Repo – Chef Repo是Workstation或笔记本电脑上存储Chef内容的目录结构。它通常位于根目录下,例如:在Linux的/home/jsmith/chef-repo、macOS的/Users/jsmith/chef-repo、以及Windows的C:\Users\jsmith\chef-repo上。当然,它也可以被创建在系统中的任何位置(只是因为主目录更便于记住和引用)。一种常用的做法是,使用Git或其他版本控制工具,为版本、远程保存和共享代码初始化相应的目录。
- Test Kitchen – Test Kitchen通过驱动程序的插件架构,以方便用户使用Docker、VMware、Hyper-V、VirtualBox、以及其他虚拟机管理程序,在本地测试Chef Cookbook和合规性配置文件。同时,它也能够对来自Amazon EC2、Google Compute Engine和Microsoft Azure等云服务提供商的云实例进行测试。而且,用户还能够使用Test Kitchen实现快速开发、测试和代码排障。
- Chef Supermarket – 目前,Chef社区里有着4000多个由Chef工程师、以及合作伙伴编写的开源式Cookbook。Chef Supermarket为此提供了公开可用的存储库,以满足个人或组织的使用、检查或修改等特定需求。
第 1 部分:Chef Infra Server
虽然我们可以通过在Workstation上使用Chef Zero,实现在不运行完整Chef Infra Server的情况下,体验Chef,但是若要获得完整的使用体验,您最好还是运行本地或基于云端的Chef服务器。毕竟,成熟的Chef Infra Server并不需要太多的资源,单个VM或适当的云实例即可。而且,它可以为您提供在目标节点之间,存储和分发代码的完整体验。
Chef Infra Server的安装并不困难。它可以与Chef Automate和Chef Habitat Builder并行安装,以实现与应用程序的持续集成。实际上,每个Chef产品都可以使用独立的二进制文件--Chef-automate,通过“产品标志(product flag)”在大约15分钟内,对Chef服务器完成快速的安装和配置。
同时,您也可以从Amazon及其云端市场,部署Chef服务器。这些系统都已预先配置好了Chef Automate和Chef Infra Server,您只需创建一个管理员用户和一个组织即可开始使用。下面是其运行的先决条件:
- 至少2颗CPU、8 GB RAM、以及32 GB的磁盘虚拟机,运行诸如Ubuntu 20.04或CentOS 8等操作系统(注意:这是远低于生产环境的最低系统要求)。
- VM拥有静态的IP地址。
- 具有sudo权限的非root用户。
- 允许Chef服务器与Workstation、及Linux、Windows或macOS目标节点(可以是其他VM)通信的子网。
- 子网上的可选DNS条目,允许服务器、节点和Workstation通过FQDN进行通信。如果没有DNS,则需编辑Chef服务器和目标节点上的hosts文件,以便它们可以通过name相互访问。
- 或者已经完成了AWS或Azure Marketplace的部署。
请在一台原始的Linux VM中登录shell,并运行如下命令,或简单地复制deploy-chef-server.sh脚本中的内容(请在运行之前,更新变量):
- $ chmod +x deploy-chef-server.sh
- $ ./deploy-chef-server.sh
您也可以在没有脚本的情况下,通过如下步骤部署Chef服务器:
设置hostnamectl set-hostname hostname文件中的fqdn值与hostname –f的系统值相匹配,毕竟在安装的过程中,我们会使用FQDN去设置证书。
- $ hostnamectl set-hostname automate.chef.lab
通过下载可执行的独立包,去安装Chef-automate工具。
- $ curl https://packages.chef.io/files/current/latest/chef- automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef- automate && chmod +x chef-automate
请按照如下方式调整环境设置:
- $ sudo sysctl -w vm.max_map_count=262144
- $ sudo sysctl -w vm.dirty_expire_centisecs=20000
为了防止重启后发生变化,请确保写入/etc/sysctl.conf。即,通过执行Chef-automate来部署Chef Infra Server:
- $ sudo ./chef-automate deploy --product infra-server
为了能够在服务器和Workstation之间提供安全的访问,并定位Chef内容,请使用Chef服务器来创建管理员用户和组织。我们可以通过chef-server org-create命令,使用--association-user参数来创建用户名admin:
- $ sudo Chef-server-ctl user-create jsmith Jack Smith jsmith@gmail.com "password" --filename jsmith.pem
- $ sudo Chef-server-ctl org-create lab“我的实验室”--association_user jsmith --filename lab-validator.pem
上述命令生成了jsmith.pem和lab-validator.pem两个证书文件。在第 2 部分中,我们将把jsmith.pem文件复制到Workstation上,以实现Chef服务器和笔记本电脑之间的安全通信。
第 2 部分:Chef Workstation
作为一组工具,Chef Workstation包括Chef、knife、inspec、cookstyle、habitat、kitchen、以及嵌入式Ruby等依赖项。您可以通过下载特定于操作系统的安装程序,或使用Chef install.sh脚本,来安装Chef Workstation。
如果使用特定于操作系统的安装程序,请在环境中设置Chef shell-init,并添加嵌入式Chef二进制文件的路径。这可以确保Workstation工具使用嵌入式的Ruby版本。其中,在Linux系统上的语句为:
- $ echo 'eval "$(chef shell-init bash)"' >> /home/$USER/.bash_profile
- $ echo 'export PATH="/opt/chef-workstation/embedded/bin:$PATH"' >> /home/$USER/.configuration_file
我们可以通过在终端上运行如下命令,来确认安装:
- $ chef -v
- Chef Workstation version: 21.10.640
- Chef CLI version: 5.4.2
- Chef Habitat version: 1.6.351
- Test Kitchen version: 3.1.0
- Cookstyle version: 7.25.6
- Chef Infra Client version: 17.6.18
- Chef InSpec version: 4.46.13
我们继续使用Chef生成器,来为所有的Chef Cookbook和其他文件创建Chef存储库,以及包括~/chef-repo/cookbooks在内的多个子目录:
- $ cd ~
- $ chef generate repo chef-repo
为了便于Workstation能够与Chef服务器进行通信和交互,我们需要创建一个凭证文件。它位于主目录中的.chef目录中,例如:/home/jsmith/.chef。该文件夹和凭据文件,可以由另一个生成器所创建:
- $ knife configure init-config
在终端里运行上述命令时,系统会向您提出包括:Chef服务器的URL和设置服务器时创建的用户名等问题。而命令完成后,系统会输出~/.chef/credentials文件,其内容为:
- [default]
- client_name = 'jsmith'
- client_key = '~/.chef/jsmith.pem'
- Chef_server_url = 'https://automate.chef.lab/organizations/lab'
通过编辑凭据文件,我们可以添加默认的cookbook位置,在本例中为~/chef-repo。当然,您也可以添加多个路径,例如:['/path/to/one', '/path/to/two']:
- cookbook_path = ['~/chef-repo/cookbooks']
上述.credentials文件中的client_key条目,会指向user.pem文件。我们可以将此文件从Chef服务器复制到Workstation,并使用scp之类的工具,将其放入~/.chef/目录。当然,您也可以复制Chef服务器上的user.pem文件内容,并粘贴到Workstation上的新文件中:
- $ cd ~ / .chef
- $ scp jsmith@automate.chef.lab:/home/jsmith/jsmith.pem。
接着,Chef Workstation会自动将准备好的证书放入~/.chef/trusted_certs文件夹中,以用于安全通信。
- $ knife ssl fetch
- $ knife ssl check
成功验证了证书后,我们可以使用另一个简单的Knife命令,去测试Workstation和 Chef服务器之间的连接。它将返回我们在设置Chef服务器时,所创建的客户端组织的名称:
- $ knife client list
- lab-validator
在完成了Chef Infra Server和Chef Workstation的设置后,我们可以开始使用Chef来配置和管理各个节点了。值得注意的是,这些配置步骤虽然对于实验室和企业内部环境都是理想的,但是在生产环境中,请务必遵循Chef服务器的系统要求。
接着,请在Workstation上安装VS Code并添加Chef扩展。其自动化完成功能和内置的Chef语言参考,会使您能够轻松地开始编写Chef代码。
第 3 部分:Chef Cookbook
在本节中,我们将创建一个简单的cookbook,以便在系统上运行Chef客户端代理时进行各项操作。
为了让Chef实现系统的自动化和合规性,Chef Infra Client会通过bootstrap进程被安装在每个节点上,并伴随着安装一个能够与Chef服务器进行通信client.rb文件。据此,您可以使用简单的Cookbook来自动化该过程,以实现系统每隔30分钟检查一次Chef服务器。
下面,我们将从近250个内置的Chef资源中,选用windows_task和cron源,通过创建一个recipe,在Linux和Windows系统上实现每隔30分钟运行一次Chef-client。其中,Linux是通过cron完成作业的;而Windows则是通过Windows Task完成的。
创建Cookbook
在Workstation上,请导航到~/chef-repo/cookbooks文件夹,并使用Chef cookbook生成器来创建一个名为run-chef-client的cookbook:
- $ cd ~/chef-repo/cookbooks
- $ Chef generate Cookbookrun-chef-client -k dokken
这将创建一个名为run-chef-client的新目录。其中,-k dokken标志生成一个Test Kitchen的kitchen.yml文件,实现预配置与Docker的协同。
请通过如下命令,切换到新的./run-chef-client目录,并列出其具体内容:
- $ cd ~/chef-repo/cookbooks/run-chef-client
- $ tree
- ├── CHANGELOG.md
- ├── chefignore
- ├── kitchen.yml
- ├── LICENSE
- ├── metadata.rb
- ├── Policyfile.rb
- ├── README.md
- ├── recipes
- │ └── default.rb
- └── test
- └── integration
- └── default
- └── default_test.rb
请使用如下命令创建两个目录,来分别保存属性(使用另一个Chef生成器)与合规性配置文件:
- $ cd ~/chef-repo/cookbooks/run-chef-client
- $ chef generate attribute default $ mkdir -p ./compliance/profiles
我们可以通过编辑metadata.rb文件,来包含维护者的信息。这些信息将被自动传递到Chef生成器,以创建诸如recipes、文件和模板等文件:
- name 'run-chef-client'
- maintainer 'John Tonello'
- maintainer_email 'jtonello@chef.lab'
- license ' Apache-2.0'
- description 'Set chef-client to run every 30 minutes'
- version '0.1.0'
- chef_version '>= 16.0'
您在创建cookbook时,可以通过如下命令,标志maintainer、maintainer_email和license的值。
- $ chef generate cookbook run-chef-client -k dokken -C 'John Tonello' -m 'jtonello@chef.lab' -I 'apachev2'
创建Recipe
请将如下内容输入./cookbooks/run-chef-client/recipes/default.rb文件,并按需更新其标题。注意,用户和密码应匹配您的环境。该recipe包括了在Windows和非Windows系统上工作的逻辑。在更为复杂的Cookbook中,您可能有不同名称的多个Cookbook。注意,请务必将带有路径的include_recipe资源运用到default.rb的recipe上。
- # Cookbook:: client-run
- # Recipe:: default
- #
- # Copyright:: 2021, John Tonello, All Rights Reserved.
- include_profile 'run-chef-client::client-run'
- if platform?('windows')
- windows_task 'run-chef-client' do
- user 'WIN10\jtonello'
- password 'Sup3r!Us3r!'
- command 'chef-client'
- run_level :highest
- frequency :minute
- frequency_modifier 30
- end
- else
- cron 'Run chef-client every 30 minutes' do
- minute '0,30'
- user 'root'
- command '/usr/bin/chef-client'
- action :create
- end
- end
其中,include_profile一行是Chef Infra Client 17.5.22的一项新功能。它允许您定义要在recipe中正确关联到Cookbook的合规性资料。据此,当您在第 5 部分中使用Policyfile工作流时,您的配置文件将被链接和上传。而在Chef中,'run-chef-client::client-run'是指向~/chef-repo/cookbooks/run-chef-client/compliance/profiles/client-run/的。
该recipe中的if...else语句会告知Chef去运行windows_task(如果平台是 Windows)或cron资源(如果平台是Linux和macOS)。而且,Windows Task需要用到用户、密码、以及以该用户的身份去运行的chef-client命令。最终,这两种资源都会将任务设置为每30分钟运行一次。
在保存了recipe后,我们便可以通过运行Chef Cookstyle,来检查其语法是否正确。如果检测到错误,它会使用-a标志来予以自动更正。
- $ cookstyle -a
当结果报告“没有违规”时,Cookbook可被认为在语法上是正确的。
如果您只想将cookbook应用到一个节点,并不想添加合规性的话,则可以将cookbook上传至Chef服务器,引导单个节点,然后应用至cookbook。下面代码展示了该过程,不过,这往往认为是一种比较旧的工作流程:
- $ knife cookbook upload run-chef-client
- $ knife cookbook list
- chef-client 0.1.0
- $ knife bootstrap ubuntuserver01.fakedomain.tld -U ubuntu -i ~/.ssh/id_rsa.pub --sudo -N ubuntuserver01 -r 'recipe[run-chef-client]'
第 4 部分:Chef InSpec Profile
Chef InSpec Profiles提供了对于节点状态、及其合规性的洞察。也就是说,它会告诉您所应用的Cookbook是否处于期望状态。
当您从终端和Chef Automate Compliance仪表板处运行Chef-client命令时,Chef InSpec会执行复杂的任务,并通过CLI报告合规性数据。在完成该任务之后,您需要创建一个cookbook属性文件、以及一个包含有controls的配置文件。
创建属性文件
请在run-chef-clientCookbook文件夹的根目录中,运行如下命令,以在run-chef-clientCookbook文件夹中生成一个属性目录。同时,该文件夹也包含一个名为default.rb的文件:
- $ chef generate attribute default
您可以编辑./attributes/default.rb,并添加如下内容:
- default['audit']['reporter'] = %w(chef-server-automate cli)
默认的['audit']['reporter']条目会输出到Chef自动化和CLI处。
创建配置文件并编辑inspec.yml文件
我们可以使用Chef生成器,生成一个新的配置文件:
- $ inspec init profile [path-to-cookbook-root] [profile-name]
例如:
- $ cd ~/chef-repo/cookbooks/run-chef-client/compliance/profiles/
- $ inspec init profile client-run
上述命令会在新的./compliance/profiles/client-run目录中创建多个文件夹和文件,其中包括一个带有示例内容的controls/example.rb文件和一个inspec.yml文件。通过编辑inspec.yml,您可以按需修改其中的粗体项:
- name: client-run
- title: Run the chef-client every 30 minutes
- maintainer: John Tonello
- copyright: John Tonello
- copyright_email: jtonello@chef.lab
- license: Apache-2.0
- summary: Run the chef-client every 30 minutes
- version: 0.1.0
- supports:
- platform: os
创建InSpec配置文件
InSpec配置文件通过control,不但描述了待执行的每个测试,也向Chef-client表明了系统信息。在如下示例中,名为run-chef-client的control的impact为1.0,即具有最高优先级。接着,control会根据目标节点是否为Windows,来运行不同的测试。此处的describe条目会告知Chef去检查每个系统上的资源。
请将./compliance/profiles/client-run/controls/example.rb重命名为default.rb,并按如下方式进行编辑:
- control 'run-chef-client' do
- impact 0.7
- title 'Run the chef-client every 30 minutes'
- if os.windows?
- describe windows_task('run-chef-client') do
- it { should exist }
- it { should be_enabled }
- end
- else
- describe crontab do
- its('commands') { should include '/usr/bin/chef-client' }
- its('minutes') { should include '0,30' }
- end
- end
- end
第 5 部分:策略文件(Policyfiles)
我们在创建任何Chef cookbook时,都需要重点考虑它是否包含了受信任的代码。通过使用Policyfiles,您可以创建不可变的对象集-Cookbook、recipe、配置文件,并确保代码未以某种方式(意外或恶意)被更改。
我们在使用Chef生成器命令创建run-chef-client cookbook时,会在cookbook文件夹中自动创建一个Policyfile.rb文件。我们可以在编辑器中打开该文件,并按需进行修改(如下代码所示):
- # Policyfile.rb - Describe how you want Chef Infra Client to build your system.
- # A name describes what the system you're building with Chef does.
- name 'run-chef-client'
- # Where to find external cookbooks:
- default_source :chef_repo, "~/chef-repo/cookbooks" do |s|
- s.preferred_for "run-chef-client"
- end
- default_source :supermarket
- default_source :chef_server, 'https://automate.chef.lab/organization/lab
- # run_list: chef-client will run these recipes in the order specified.
- run_list 'run-chef-client::default'
其中的name条目指定了与Cookbook相符的Policyfile名称。而default_source可以是服务器的Chef、Chef Supermarket、或本地Chef repo。通过将:chef_repo与s.preferred_for一起使用,Chef将在Workstation的cookbooks文件夹中查找到内容,而不是Chef Supermarket之类的远程源,或Chef服务器本身。
而run_list条目则描述了Chef的Cookbook和路径。在此,run-chef-client::default指向的是~/chef-repo/cookbooks/run-chef-client/recipes/default.rb。您也可以添加多个run_list项,并通过创建配置文件,将多个不同的cookbook结合到一个不可变的Policyfile中。
完成之后,请继续在run-chef-client的Cookbook目录中运行cookstyle -a,并在下一步之前仔细检查其语法:
- $ cd ~/chef-repo/cookbooks/run-chef-client
- $ cookstyle -a
一次性上传Cookbook和配置文件
使用Policyfiles,您可以捆绑cookbook和合规性配置文件,并将它们上传到Chef服务器上。首先,请安装Policyfile.rb,以创建Policyfile.lock.json文件;然后请将该文件推送到Chef服务器处。
- $ cd ~/chef-repo/cookbooks/run-chef-client
- $ chef install Policyfile.rb
- $ Chef push prod Policyfile.lock.json
该推送命令包含了Policyfile所属的策略组(Policy Group)。使用Chef,您可以为不同的目的创建不同的策略组,例如build、test和prod等。在本示例中,run-chef-client的cookbook和client-run配置文件会被添加到prod(生产环境)策略组。
有了./compliance/profiles/default/default.rb、inspec.yml和Policyfile.rb,你便可以使用Test Kitchen测试Cookbook和合规性控制,或直接跳到第 7 部分,在目标节点上应用run-chef-client的cookbook和配置。
用Knife上传Cookbook
您可以使用简单的Knife命令,将Cookbook上传到Chef服务器处,然后将一到多个Cookbook分配给每个节点。其对应的命令代码如下:
- $ knife upload cookbook run-chef-client
- $ knife node run_list add ubuntu01 'recipe[run-chef-client']
其中,第一个命令是将Cookbook上传到Chef服务器;第二个指定run-chef-client的Cookbook在该节点上运行。
第 6 部分:Test Kitchen
Test Kitchen提供了诸如Docker、VirtualBox、Hyper-V、Amazon以及Azure云等多种方法,在本地测试Chef Cookbook和合规性代码。由于我们在本例中使用的是Docker,因此应当在Workstation上安装docker.io和docker -compose,并以非root的用户身份去运行。
我们在使用-k dokken标志去创建run-chef-clientcookbook时,会自动在cookbookkitchen.yml目录的根目录下创建一个文件。如下代码所示,该文件已经被配置为使用Dokken驱动程序(即为Docker)了。
- ---
- driver:
- name: dokken
- privileged: true # allows systemd services to start
- provisioner:
- name: dokken
- transport:
- name: dokken
- verifier:
- name: inspec
- platforms:
- - name: ubuntu-20.04
- driver:
- image: dokken/ubuntu-20.04
- pid_one_command: /bin/systemd
- intermediate_instructions:
- - RUN /usr/bin/apt-get update
- - name: centos-8
- driver:
- image: dokken/centos-8
- pid_one_command: /usr/lib/systemd/systemd
- suites:
- - name: default
- run_list:
- - recipe[chef-client::default]
- verifier:
- inspec_tests:
- - compliance/profiles/client-run/
- attributes:
- audit:
- compliance_phase: false
- reporter: 'cli'
类似虚拟机,上述kitchen.yml文件中的platform条目会拉取特殊的Docker镜像。而Chef团队已经为各种Linux操作系统准备了基本的容器,以便您为真实的环境开展测试,而无需额外的设置。
如果您想添加除了Ubuntu 20.04和CentOS 8之外的平台,则可以通过https://hub.docker.com/u/dokken,添加来自dokken镜像存储库里的条目。那里有着41个Dokken镜像可供测试。
您也可以编辑suites下的verifier部分,以指向InSpec配置文件的相对路径——compliance/profiles/client-run/。通过有效性验证,它将有助于避免运行时的各种错误:
- attributes:
- audit:
- compliance_phase: false
- reporter: 'cli'
运行Test Kitchen
Test Kitchen的工作原理是:首先根据kitchen.yml平台条目中所描述的镜像,启动容器(如VM或云实例),接着部署Chef-client和Chef配置文件,然后部署Chef代码(被称为converging),并验证您的代码,最后关闭并销毁测试容器或实例。您可以通过导航到run-chef-clientCookbook目录的根目录,运行kitchen test,来一次性完成所有步骤:
- $ cd ~/chef-repo/cookbooks/run-chef-client
- $ kitchen test
上述简单的命令执行了创建、聚合、验证和销毁步骤,并能显示正在使用的Cookbook的终端内结果,以及合规阶段的扫描结果。您可以继续执行如下步骤:
- $ kitchen create
- $ kitchen converge
- $ kitchen verify
- $ kitchen destroy
通过单独运行上述步骤,您可以重新运行kitchen converge和kitchen verify,以快速迭代各种更改。
第 7 部分:引导节点
既然cookbook和配置文件已推送到了Chef服务器并进行了测试,下面,我们将引导(bootstrapping)第一个目标节点并执行如下任务:
- 安装Chef-client
- 创建配置文件--config.rb,并定义Chef Server和身份验证等详细信息
- 按需安装可信任的自签名证书
Knife有一个内置的引导命令,可以一次性完成所有步骤。您可以在首个Chef Workstation的目标节点(应当能够默认支持ssh系统)上,引导如下命令:
- $ knife bootstrap ubuntu01.fakedomain.tld -U ubuntu -i ~/.ssh/id_rsa --sudo -N ubuntu01 --policy-group prod --policy-name run-chef-client
该bootstrap命令允许您使用如下标志来定义各种细节:
- ubuntu01.fakedomain.tld – 没有标志,只有被引导服务器的主机名或IP地址。
- -U(或--connection-user)ubuntu – 连接到远程节点时用到的用户名。
- -i ~/.ssh/id_rsa – ssh的身份验证密钥(而-P可用于密码验证)。
- –-sudo – 以超级用户的权限执行命令。这通常是新软件安装和引导所必需的。
- -N(或 --node-name)ubuntu01 – 向Chef服务器注册时使用的“节点名称”。
- --policy-group prod --policy-name run-chef-client – 它会将run-chef-clientpolicy分配给节点。您可以使用-r 'recipe[run-chef-client]'在引导期间将Cookbook应用于节点上。在本例中,default.rb recipe被应用了上去。
- $ knife bootstrap ssh://10.128.1.25 -U ubuntu -i ~/.ssh/id_rsa -N ubuntu01 -r 'recipe[run-chef-client]'
Windows:
- $ Knife bootstrap winrm://10.128.1.26 -U Administrator -P mypassword -N windows10 -r 'recipe[run-chef-client]'
同时,您也可以引导节点,而不是分配任何recipe或策略:
- $ Knife bootstrap ssh://10.128.1.25 -U ubuntu -i ~/.ssh/id_rsa -N ubuntu01
- $ Knife bootstrap winrm://10.128.1.26 -U Administrator -P mypassword -N windows10
如果您想在没有任何标志的情况下,引导一到多个节点,则可以稍后再设置策略,并分配run_lists或策略:
- $ Knife node policy set ubuntu01 prod run-chef-client
或者:
- $ Knife node run_list add ubuntu01 'recipe[run-chef-client]'
上面只是一些常用的选项。如果您想了解更多有关Knife命令的完整标志列表,只需使用-h标志,即可获得全量选项和用法示例的描述。
通过运行Chef-client来查看系统的状态和合规性
您可以通过knife,在Chef服务器列表中查询到ubuntu01节点:
- $ knife node list
- ubuntu01
如果使用策略或recipe的标志去引导节点,您将在CLI中看到进度显示和结果输出。当然,您也可以通过在该节点上运行的Chef-client,以查看到Chef代码的运行情况。虽然新的run-chef-client cookbook会每隔30分钟运行一次,但您可以通过以下几种方式,来手动执行:
使用knife运行Chef-client
knife工具允许您在任何远程节点上运行ssh和winrm选项。在Linux或macOS节点上,您可以通过如下方式,来运行命令sudo chef-client:
- $ knife ssh 'name:ubuntu01' 'sudo Chef-client'
值得一提的是,如果目标主机是Windows系统,那么请使用winrm选项,并提供管理级别的用户名(-x)和密码(-P):
- $ knife winrm 'name:win10' 'chef-client' -x Administrator -P mypassword
而对于支持ssh的节点,您可以进入shell,并从命令行运行sudo chef-client;在Windows上,则请使用RDP登录,以管理员身份打开PowerShell,然后运行chef-client。
不仅仅是策略即代码(Policy as Code)
由于本例中的ubuntu01节点已经被Chef Infra Client和Chef代码引导启动和运行,因此您可以通过如下命令,快速了解到其相关信息的摘要:
- knife node show ubuntu01
- Node Name: ubuntu01
- Policy Name: run-chef-client
- Policy Group: prod
- FQDN: ubuntu01.fakedomain.tld
- IP: 10.128.1.25
- Run List: recipe[run-chef-client::default]
- Recipes: run-chef-client::default
- Platform: ubuntu 20.04
- Tags:
您还可以使用Chef查询与该节点相关的各种系统信息。例如:
- $ knife search node 'name:ubuntu01' -a shells
- 1 items found
- ubuntu01:
- shells:
- /bin/sh
- /bin/bash
- /bin/rbash
- /bin/dash
上例只是搜索并返回了单个节点。当然,您也可以使用通配符,返回有关所有节点、或具有特定前缀或后缀的节点信息。例如:'name:*'(所有节点)、或'name:web*'(仅以“web”开头的节点)、或'name:*web'(仅以“web”结尾的节点)。除了名称以外,您还可以使用平台、或其他knife选项。例如:
- $ knife search node 'platform:ubuntu' -a shells
这些信息从何而来?
即使您没有使用Chef对节点实施任何配置上的更改,Chef-client的每次运行也都会使用一个名为ohai的工具,来收集系统分析信息,并将它与运行结果一起发送回Chef服务器。这就意味着,您可以开箱即用地了解有关被管理系统的各种信息,并且能够随着更多服务器被引导,而轻松地查询到更多与Chef相关的信息,进而在recipe中使用此类信息,来操控各个节点。
以下便是从Chef中提取更多数据类型的示例:
- $ knife search node 'name:ubuntu01' -a memory.total -a filesystem.by_mountpoint./.percent_used -a ipaddress
- 1 items found
- ubuntu01:
- filesystem.by_mountpoint./.percent_used: 13%
- ipaddress: 10.128.1.133
- memory.total: 524288kB
在此搜索中,您可以查看有关磁盘的使用情况和内存的数据。Ohai允许您通过查询各种节点的信息,来自动检测诸如节点的公共IP地址等AWS的内部信息。对此,您可以将-a ec2.public_ipv4替换上例中的-a ipaddress。值得注意的是,即使您的节点是在没有应用run_list或策略的情况下被引导的,它也能够收集到数据。
关于属性的更多想法
我们在节点上对于Cookbook节点的任何修改,都可以被直接执行,而无需变动任何底层代码的属性。例如,您可以通过在节点上运行一个knife搜索,后跟-l标志,来查看某个节点的所有可用属性:
- $ knife search node 'name:ubuntu01' -l
- 1 items found
- Node Name: ubuntu01
- Policy Name: run-chef-client
- Policy Group: prod
- FQDN: ip-172-31-15-141.ec2.internal
- IP: 3.85.154.118
- Run List: recipe[run-chef-client::default]
- Recipes: run-chef-client::default
- Platform: ubuntu 20.04
- Tags:
- Attributes:
- tags:
- …
- chef_environment: prod
- chef_guid: 4d10ca10-7658-4693-91b6-6ed25d881a1c
- chef_packages:
- chef:
- chef_effortless:
- chef_root: /opt/chef/embedded/lib/ruby/gems/3.0.0/gems/chef-17.5.22/li
- b
- version: 17.5.22
- ohai:
- ohai_root: /opt/chef/embedded/lib/ruby/gems/3.0.0/gems/ohai-17.5.2/lib/ohai
- version: 17.5.2
- cloud:
- local_hostname: ip-172-31-15-141.ec2.internal
- local_ipv4: 172.31.15.141
- local_ipv4_addrs: 172.31.15.141
- provider: ec2
- public_hostname: ec2-3-85-154-118.compute-1.amazonaws.com
- public_ipv4: 3.85.154.118
- public_ipv4_addrs: 3.85.154.118
- command:
- ps: ps -ef
- cookbooks:
- run-chef-client:
- version: 0.1.0
- counters:
- network:
- interfaces:
- eth0:
- rx:
- bytes: 396541197
- drop: 0
- errors: 0
- …
第 8 部分:扩展所学的内容
至此,您已经了解了Chef是如何协同Cookbook工作的。但是在实际应用中,您可能需要诸如:在webserver上打开443端口、或是在其他服务器上安装特定的应用等多种配置。因此,您可以使用多种方式,将多个Cookbook组合在一起,提供可应用于被定义节点组的基本Cookbook或配置文件。例如,Policyfiles就能够简便地将多个Cookbook、recipe和配置文件捆绑在一个对象中。而另一种方法则是将Cookbook依赖项添加到Cookbook的metadata.rb文件中,并在default.rbCookbook中使用include_recipe资源。
在metadata.rb中定义依赖项
每个cookbook都带有一个metadata.rb文件,可用于定义其名称、版本、以及各种依赖项。如下代码展示了,若想添加对另一个cookbook的依赖项,只需告知其您的run-chef-clientcookbook,以及向metadata.rb添加一个depends条目即可:
- name 'base_cookbook'
- maintainer 'Jack Smith'
- maintainer_email 'jsmith@example.com'
- license 'Apache-2.0'
- description 'Installs/Configures base_cookbooks'
- long_description 'Installs/Configures base_cookbooks'
- version '0.1.0'
- chef_version '>= 16.0'
- depends 'run-chef-client'
在recipes/default.rb中定义Cookbook依赖项
在第 3 部分中,我们了解到cookbook包含着一个default.rbrecipe,该recipe定义了在未指定其他特定recipe时,应执行哪些操作。而在该base_cookbook示例中,cookbook定义了与其相关的recipe。那么,如果您有第二个名为closed-ports的cookbook,它会在自己的cookbook和recipe目录中拥有自己的default.rb。而如果要在应用run-chef-clientcookbook时,调用closed-ports这一cookbook,您可以在修改后使用include_recipe资源,并读取cookbooks/run-chef-client/recipes/default.rb。
- #
- # Cookbook:: base_cookbook
- # Recipe:: default
- #
- # Copyright:: 2021, Jack Smith, All Rights Reserved.
- include_recipe 'closed-ports::default'
通过这种方式,您可以创建基本的Cookbook,以包含多个recipe和Cookbook。而且,当您在使用Policyfiles时,它是固定不变的,并能够将一到多个cookbook中的所有内容捆绑到一起(包括已定义的任何InSpec配置文件)。可见,由于不需要旧的Chef技术来上传Cookbook依赖项,因此Policyfile方法应作为开发的首选。
更多资源
如果您在开始动手实践之前,想了解更多相关知识的话,请浏览如下链接:
- Chef的部署知识
- 从基本到高级的Chef技术
- 如何安装Chef automation和Chef Infra Server(视频)
- 如何构建Chef Workstation,创建Cookbook与合规性(视频)
原文标题:Chef 101: Getting Started With Automation,作者: John Tonello
【51CTO译稿,合作站点转载请注明原文译者和出处为51CTO.com】
原文链接:https://developer.51cto.com/art/202111/689421.htm