LDF702 - Installation du Chef Infra Server et du Chef Workstation

• LDF702 - Chef Infra Server et Chef Workstation
  • Contenu du Module
  • Infrastructure
  • LAB #1 - Installer et Configurer Chef Infra Server
    • 1.1 - Presentation
    • 1.2 - Installation
    • 1.3 - Configuration
    • 1.4 - Installation et Configuration de l'Interface Web
  • LAB #2 - Installer et Configurer Chef Workstation
    • 2.1 - Présentation
    • 2.2 - Installation
    • 2.3 - Configuration

L'infrastructure utilisée dans ce module est la suivante.

Stagiaires 11, 12, 14, 15, 16 et 17 :

Stagiaires 18, 19, 20, 21, 22 et 23 :

Rappelez-vous que Chef supporte de multiples OS en tant que clients :

• Red Hat,
• CentOS,
• Ubuntu,
• Oracle Linux,
• MacOS™,
• AIX™,
• Solaris™,
• Windows™.

Le Chef Infra Server nécessite une des distributions Linux suivantes :

• Red Hat Enterprise Server / CentOS versions 6 ou 7,
• SUSE Linux Enterprise Server versions 11 ou 12,
• Ubuntu Linux versions, 14.04, 16.04 ou 18.04.

La configuation minimale de Chef Infra Server est :

• architecture 64 bits,
• les ports 80 et 443 doivent être ouverts,
• serveur NTP installé,
• 4 coeurs physiques ou virtuels,
• 4 - 8 Go de RAM,
• 5 Go d'espace disque dans /var,
• 5 Go d'espace disque dans /opt.

Connectez-vous ensuite à votre VM ChefServer_10.0.2.110_SSH ou ChefServer_10.0.3.110_SSH selon votre numéro de stagiaire.

Devenez l'utilisateur root :

trainee@chefserver:~$ sudo su -
[sudo] password for trainee: trainee

Installez le paquet curl :

root@chefserver:~# apt update
...
root@chefserver:~# apt install curl -y
...

Créez maintenant deux répertoires à la racine du filesystem :

root@chefserver:~# mkdir /key
root@chefserver:~# mkdir /downloads

Téléchargez le paquet chef-server-core_13.0.17-1_amd64.deb vers le répertoire /downloads :

root@chefserver:~# wget -nv -P /downloads https://packages.chef.io/files/stable/chef-server/13.0.17/ubuntu/18.04/chef-server-core_13.0.17-1_amd64.deb
2023-10-30 13:16:56 URL:https://packages.chef.io/files/stable/chef-server/13.0.17/ubuntu/18.04/chef-server-core_13.0.17-1_amd64.deb [252269838/252269838] -> "/downloads/chef-server-core_13.0.17-1_amd64.deb" [1]

Installez le paquet chef-server-core_13.0.17-1_amd64.deb :

root@chefserver:~# dpkg -i /downloads/chef-server-core_13.0.17-1_amd64.deb
Selecting previously unselected package chef-server-core.
(Reading database ... 184142 files and directories currently installed.)
Preparing to unpack .../chef-server-core_13.0.17-1_amd64.deb ...
Unpacking chef-server-core (13.0.17-1) ...
Setting up chef-server-core (13.0.17-1) ...

Utilisez la commande chef-server-ctl reconfigure pour procéder à une configuration initiale de Chef Infra Server :

root@chefserver:~# chef-server-ctl reconfigure
...
Running handlers:
Running handlers complete
Chef Infra Client finished, 482/1028 resources updated in 05 minutes 44 seconds
Chef Server Reconfigured!

En utilisant la commande curl, vérifiez que Chef Infra Server est démarré :

root@chefserver:~# curl -D - http://localhost:8000/_status | grep "200 OK"
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   483  100   483    0     0  HTTP/1.1 200 OK
 6616      0 --:--:-- --:--:-- --:--:--  6616

Créez maintenant l'utilisateur chefadmin ayant un mot de passe fenestros :

root@chefserver:~# chef-server-ctl user-create chefadmin Chef Admin infos@ittraining.team fenestros --filename /key/chefadmin.pem

Créez ensuite l'organisation chefacademy associée à l'utilisateur chefadmin :

root@chefserver:~# chef-server-ctl org-create chefacademy "Chef Academy." --association_user chefadmin --filename /key/chefacademy.pem

Vérifiez que tous les services sont en cours de fonctionnement :

root@chefserver:~# chef-server-ctl service-list
bookshelf*
nginx*
oc_bifrost*
oc_id*
opscode-erchef*
opscode-expander*
opscode-solr4*
postgresql*
rabbitmq*
redis_lb*

L'interface web de Chef Infra Server nécessite l'installation de chef-manage :

root@chefserver:~# chef-server-ctl install chef-manage
Starting Chef Infra Client, version 15.0.300
resolving cookbooks for run list: ["private-chef::add_ons_wrapper"]
Synchronizing Cookbooks:
  - private-chef (0.1.1)
  - runit (5.1.1)
  - enterprise (0.15.1)
  - yum-epel (3.3.0)
  - packagecloud (1.0.1)
Installing Cookbook Gems:
Compiling Cookbooks...
Converging 4 resources
Recipe: private-chef::add_ons_wrapper
  * ruby_block[addon_install_notification_chef-manage] action nothing (skipped due to action :nothing)
  * remote_file[/var/opt/opscode/local-mode-cache/chef-manage_3.3.66-1_amd64.deb] action create
    - create new file /var/opt/opscode/local-mode-cache/chef-manage_3.3.66-1_amd64.deb
    - update content in file /var/opt/opscode/local-mode-cache/chef-manage_3.3.66-1_amd64.deb from none to 9713b2
    (file sizes exceed 10000000 bytes, diff output suppressed)
  * ruby_block[locate_addon_package_chef-manage] action run
    - execute the ruby block locate_addon_package_chef-manage
  * apt_package[chef-manage] action install
    - install version 3.3.66-1 of package chef-manage
  * ruby_block[addon_install_notification_chef-manage] action run
    - execute the ruby block addon_install_notification_chef-manage

Running handlers:
-- Installed Add-On Package: chef-manage
  - #<Class:0x0000000004db2ed8>::AddonInstallHandler
Running handlers complete
Chef Infra Client finished, 4/5 resources updated in 47 seconds

Reconfigurez Chef Infra Server pour prendre en compte l'installation précédente :

root@chefserver:~# chef-server-ctl reconfigure
...
Running handlers:
Running handlers complete
Chef Infra Client finished, 52/553 resources updated in 01 minutes 03 seconds
Chef Server Reconfigured!

Procédez ensuite à la configuration de chef-manage :

root@chefserver:~# chef-manage-ctl reconfigure
...
Infra Phase complete, 97/273 resources updated in 38 seconds
[2023-10-30T13:40:51+01:00] WARN: This release of Chef Infra Client became end of life (EOL) on May 1st 2023. Please update to a supported release to receive new features, bug fixes, and security updates.
chef-manage Reconfigured!

Connectez-vous ensuite à votre VM ChefServer_10.0.2.110_VNC ou ChefServer_10.0.3.110_VNC selon votre numéro de stagiaire.

Ouvrez le navigateur Web et naviguez à l'adresse 10.0.2.110 ou 10.0.3.110 selon le cas. Acceptez ensuite le certificat :

Vous obtiendrez :

Renseignez l'utilisateur chefadmin et le mot de passe fenestros puis cliquez sur le bouton Sign In :

Vous obtiendrez :

Rappelez-vous que Chef Workstation contient les exécutables suivantes :

• ChefDK
• Chef-run
• Chef Infra Client
• Chef-repo

La configuation minimale de Chef Workstation est :

• 4 Go de RAM
• 4 Go d'espace disque

La configuation recommendée de Chef Workstation est :

• 4 Go de RAM
• 8 Go d'espace disque

Connectez-vous ensuite à votre VM ChefServer_10.0.2.110_SSH ou ChefServer_10.0.3.110_SSH selon votre numéro de stagiaire.

Connectez-vous à votre Chef Workstation à partir de votre Chef Infra Server en utilisant l'IP associée à votre numéro de stagiaire.

Stagiaires 11, 12, 14, 15, 16 et 17 :

root@chefserver:/key# ssh -l trainee 10.0.2.111
trainee@10.0.2.111's password: 
Welcome to Ubuntu 18.04.6 LTS (GNU/Linux 5.4.0-150-generic x86_64)

 * Documentation:  https://help.ubuntu.com
 * Management:     https://landscape.canonical.com
 * Support:        https://ubuntu.com/advantage

Expanded Security Maintenance for Infrastructure is not enabled.

0 updates can be applied immediately.

Enable ESM Infra to receive additional future security updates.
See https://ubuntu.com/esm or run: sudo pro status

New release '20.04.6 LTS' available.
Run 'do-release-upgrade' to upgrade to it.

Your Hardware Enablement Stack (HWE) is supported until April 2023.
Last login: Mon Oct 30 14:39:59 2023 from 10.0.2.110

Stagiaires 18, 19, 20, 21, 22 et 23 :

root@chefserver:/key# ssh -l trainee 10.0.3.111
trainee@10.0.2.111's password: 
Welcome to Ubuntu 18.04.6 LTS (GNU/Linux 5.4.0-150-generic x86_64)

 * Documentation:  https://help.ubuntu.com
 * Management:     https://landscape.canonical.com
 * Support:        https://ubuntu.com/advantage

Expanded Security Maintenance for Infrastructure is not enabled.

0 updates can be applied immediately.

Enable ESM Infra to receive additional future security updates.
See https://ubuntu.com/esm or run: sudo pro status

New release '20.04.6 LTS' available.
Run 'do-release-upgrade' to upgrade to it.

Your Hardware Enablement Stack (HWE) is supported until April 2023.
Last login: Mon Oct 30 14:39:59 2023 from 10.0.2.110

Créez le répertoire /downloads :

trainee@workstation:~$ sudo su -
[sudo] password for trainee: trainee
root@workstation:~# mkdir /downloads

Téléchargez le paquet chef-workstation_0.14.16-1_amd64.deb vers le répertoire /downloads :

root@workstation:~# wget -nv -P /downloads https://packages.chef.io/files/stable/chef-workstation/0.14.16/ubuntu/18.04/chef-workstation_0.14.16-1_amd64.deb
2023-10-30 15:00:10 URL:https://packages.chef.io/files/stable/chef-workstation/0.14.16/ubuntu/18.04/chef-workstation_0.14.16-1_amd64.deb [152223072/152223072] -> "/downloads/chef-workstation_0.14.16-1_amd64.deb" [1]

Installez le paquet chef-workstation_0.14.16-1_amd64.deb :

root@workstation:~# dpkg -i /downloads/chef-workstation_0.14.16-1_amd64.deb
Selecting previously unselected package chef-workstation.
(Reading database ... 184129 files and directories currently installed.)
Preparing to unpack .../chef-workstation_0.14.16-1_amd64.deb ...
Unpacking chef-workstation (0.14.16-1) ...
Setting up chef-workstation (0.14.16-1) ...

The Chef Workstation App is available for you to try.

Launch the App by running 'chef-workstation-app'.
The App will then be available in the system tray.

Thank you for installing Chef Workstation!
You can find some tips on getting started at https://chef.sh/

Configurez Ruby :

root@workstation:~# which ruby

root@workstation:~# eval "$(chef shell-init bash)"

root@workstation:~# echo 'eval "$(chef shell-init bash)"' >> ~/.bash_profile

root@workstation:~# chef shell-init bash
export PATH="/opt/chef-workstation/bin:/root/.chefdk/gem/ruby/2.6.0/bin:/opt/chef-workstation/embedded/bin:/opt/chef-workstation/bin:/root/.chefdk/gem/ruby/2.6.0/bin:/opt/chef-workstation/embedded/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/opt/chef-workstation/gitbin:/opt/chef-workstation/gitbin"
export GEM_ROOT="/opt/chef-workstation/embedded/lib/ruby/gems/2.6.0"
export GEM_HOME="/root/.chefdk/gem/ruby/2.6.0"
export GEM_PATH="/root/.chefdk/gem/ruby/2.6.0:/opt/chef-workstation/embedded/lib/ruby/gems/2.6.0"
_chef_comp() {
    local COMMANDS="exec env gem generate shell-init install update push push-archive show-policy diff export clean-policy-revisions clean-policy-cookbooks delete-policy-group delete-policy undelete describe-cookbook provision"
    COMPREPLY=($(compgen -W "$COMMANDS" -- ${COMP_WORDS[COMP_CWORD]} ))
}
complete -F _chef_comp chef

root@workstation:~# which ruby
/opt/chef-workstation/embedded/bin/ruby

Connectez-vous ensuite à votre VM ChefServer_10.0.2.110_VNC ou ChefServer_10.0.3.110_VNC selon votre numéro de stagiaire.

Ouvrez le navigateur Web et naviguez à l'adresse 10.0.2.110 ou 10.0.3.110 selon le cas :

Cliquez sur l'organisation chefacademy :

Cliquez sur le bouton Download Starter Kit :

Connectez-vous ensuite à votre VM ChefServer_10.0.2.110_SSH ou ChefServer_10.0.3.110_SSH selon votre numéro de stagiaire.

Copiez le fichier chef-starter.zip à partir de Chef Infra Server vers le répertoire courant de votre Chef Workstation.

Stagiaires 11, 12, 14, 15, 16 et 17 :

root@workstation:~# scp trainee@10.0.2.110:/home/trainee/Downloads/chef-starter.zip .
The authenticity of host '10.0.2.110 (10.0.2.110)' can't be established.
ECDSA key fingerprint is SHA256:RRU4Tim5H5klLxXUa8hyodLq5DSGrKuZ07jziXLVmFw.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '10.0.2.110' (ECDSA) to the list of known hosts.
trainee@10.0.2.110's password: 
chef-starter.zip                                    100% 7767    10.8MB/s   00:00 

Stagiaires 18, 19, 20, 21, 22 et 23 :

root@workstation:~# scp trainee@10.0.3.110:/home/trainee/Downloads/chef-starter.zip .
The authenticity of host '10.0.3.110 (10.0.3.110)' can't be established.
ECDSA key fingerprint is SHA256:RRU4Tim5H5klLxXUa8hyodLq5DSGrKuZ07jziXLVmFw.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '10.0.3.110' (ECDSA) to the list of known hosts.
trainee@10.0.3.110's password: 
chef-starter.zip                                    100% 7767    10.8MB/s   00:00 

Décompressez le fichier :

root@workstation:~# unzip chef-starter.zip 
Archive:  chef-starter.zip
  inflating: chef-repo/.gitignore    
  inflating: chef-repo/README.md     
   creating: chef-repo/cookbooks/
  inflating: chef-repo/cookbooks/chefignore  
   creating: chef-repo/cookbooks/starter/
   creating: chef-repo/cookbooks/starter/attributes/
  inflating: chef-repo/cookbooks/starter/attributes/default.rb  
   creating: chef-repo/cookbooks/starter/files/
   creating: chef-repo/cookbooks/starter/files/default/
  inflating: chef-repo/cookbooks/starter/files/default/sample.txt  
  inflating: chef-repo/cookbooks/starter/metadata.rb  
   creating: chef-repo/cookbooks/starter/recipes/
  inflating: chef-repo/cookbooks/starter/recipes/default.rb  
   creating: chef-repo/cookbooks/starter/templates/
   creating: chef-repo/cookbooks/starter/templates/default/
  inflating: chef-repo/cookbooks/starter/templates/default/sample.erb  
   creating: chef-repo/.chef/
   creating: chef-repo/roles/
  inflating: chef-repo/.chef/config.rb  
  inflating: chef-repo/roles/starter.rb  
  inflating: chef-repo/.chef/chefadmin.pem 

La configuration se trouve dans le fichier chef-repo/.chef/config.rb :

root@workstation:~# ls -l chef-repo/.chef
total 8
-rw-r--r-- 1 root root 1674 oct.  30 15:07 chefadmin.pem
-rw-r--r-- 1 root root  425 oct.  30 15:07 config.rb

En consultant ce fichier, vous constaterez l'URL du Chef Infra Server - https://chefserver/organizations/chefacademy :

root@workstation:~# cat chef-repo/.chef/config.rb 
# See https://docs.chef.io/workstation/config_rb/ for more information on knife configuration options

current_dir = File.dirname(__FILE__)
log_level                :info
log_location             STDOUT
node_name                "chefadmin"
client_key               "#{current_dir}/chefadmin.pem"
chef_server_url          "https://chefserver/organizations/chefacademy"
cookbook_path            ["#{current_dir}/../cookbooks"]

Éditez donc le fichier /etc/hosts pour pointer l'adresse 10.0.2.110 ou 10.0.3.110 vers chefserver.ittraining.loc selon votre numéro de stagiaire.

Stagiaires 11, 12, 14, 15, 16 et 17 :

root@workstation:~# vi /etc/hosts
root@workstation:~# cat /etc/hosts
127.0.0.1       localhost
127.0.1.1       workstation
10.0.2.110      chefserver.ittraining.loc   chefserver
10.0.2.111      workstation.ittraining.loc  workstation

# The following lines are desirable for IPv6 capable hosts
::1     ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

Stagiaires 18, 19, 20, 21, 22 et 23 :

root@workstation:~# vi /etc/hosts
root@workstation:~# cat /etc/hosts
127.0.0.1       localhost
127.0.1.1       workstation
10.0.3.110      chefserver.ittraining.loc   chefserver
10.0.3.111      workstation.ittraining.loc  workstation

# The following lines are desirable for IPv6 capable hosts
::1     ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

Placez-vous dans le répertoire /root/chef-repo/.chef/ et récupérez le certificat de Chef Infra Server en utilisant la commande knife :

root@workstation:~# cd chef-repo/.chef/ 
root@workstation:~/chef-repo/.chef# knife ssl fetch
WARNING: Certificates from chefserver will be fetched and placed in your trusted_cert
         directory (/root/chef-repo/.chef/trusted_certs).
         
         Knife has no means to verify these are the correct certificates. You should
         verify the authenticity of these certificates after downloading.
Adding certificate for chefserver in /root/chef-repo/.chef/trusted_certs/chefserver.crt

Vérifiez ensuite le certificat reçu :

root@workstation:~/chef-repo/.chef# knife ssl check
Connecting to host chefserver:443
Successfully verified certificates from `chefserver'

Copyright © 2023 Hugh Norris.