KITCHEN(1)

💖 KITCHEN(1) 💖

okay so bestie, welcome to the kitchen manual page (it lives in the User Commands section, iykyk) ✨

---

🌸 NAME 🌸

Kitchen — the integration tool for Chef. that's it. that's the name. slay 💅

---

🎀 DESCRIPTION 🎀

ngl, Test Kitchen is a test harness tool that lets you execute your configured code on one or more platforms in isolation. it's giving ✨science✨ but for your infrastructure.

the way it works is: there's a driver plugin architecture 💫 which means you can run your code on all kinds of cloud providers and virtualization technologies, like:

• Amazon EC2
• Blue Box
• CloudStack
• Digital Ocean
• Rackspace
• OpenStack
• Vagrant
• Docker
• LXC containers
• and more 👑

also many testing frameworks are already supported out of the box, including Bats, shUnit2, RSpec, and Serverspec, with others being created weekly. literally weekly. the girlies are busy 🐝

for Chef workflows, cookbook dependency resolver tools such as Berkshelf and Librarian-Chef are supported 🫶 or honestly you can just have a cookbooks/ directory and Test Kitchen will know what to do. it just knows. main character energy fr fr.

and support for Test Kitchen is already included in many Chef community cookbooks, such as the MySQL, nginx, Chef Server, and runit cookbooks. obsessed 😭💖

---

✨ Commands: ✨

okay bestie here's the whole menu, no skips, no cuts, we're doing all of them 💅

• kitchen console — # Kitchen Console! 🌈
• kitchen converge [INSTANCE|REGEXP|all] — # Change instance state to converge. Use a provisioner to configure one or more instances 🔧
• kitchen create [INSTANCE|REGEXP|all] — # Change instance state to create. Start one or more instances 🌱
• kitchen destroy [INSTANCE|REGEXP|all] — # Change instance state to destroy. Delete all information for one or more instances 💀 (dramatic but true)
• kitchen diagnose [INSTANCE|REGEXP|all] — # Show computed diagnostic configuration 🩺
• kitchen driver — # Driver subcommands 🚗
• kitchen driver create [NAME] — # Create a new Kitchen Driver gem project 💎
• kitchen driver discover — # Discover Test Kitchen drivers published on RubyGems 🔍
• kitchen driver help [COMMAND] — # Describe subcommands or one specific subcommand 📖
• kitchen exec INSTANCE|REGEXP -c REMOTE_COMMAND — # Execute command on one or more instance 🏃♀️
• kitchen help [COMMAND] — # Describe available commands or one specific command 🙋♀️
• kitchen init — # Adds some configuration to your cookbook so Kitchen can rock 🎸

a .kitchen.yml will be created in your project base directory. this file describes your testing configuration: what you want to test and on which target platforms. each of these suite and platform combinations are called instances 👑

by default your instances will be converged with Chef Solo and run in Vagrant virtual machines. cute, right? ✨

• kitchen list [INSTANCE|REGEXP|all] — # Lists one or more instances 📋
• kitchen login INSTANCE|REGEXP — # Log in to one instance 🔑
• kitchen setup [INSTANCE|REGEXP|all] — # Change instance state to setup. Prepare to run automated tests. Install busser and related gems on one o... 🧰
• kitchen test [INSTANCE|REGEXP|all] — # Test (destroy, create, converge, setup, verify and destroy) one or more instances 🧪 — yes it does all six, it's a whole journey
• kitchen verify [INSTANCE|REGEXP|all] — # Change instance state to verify. Run automated tests on one or more instances ✅
• kitchen version — # Print Kitchen's version information 🏷️

---

💡 quick vibe check: that setup description is verbatim-truncated as "on one o..." in the original, so we're keeping it exactly like that. no cap, don't @ me 🙈

---

and that's the whole page bestie!! 🦋🌸✨

this lil masterpiece is from Test Kitchen version 1.4.1, dated June 2015 — yeah she's a classic, an icon, a legend, and she IS the moment 👑💖 periodt 💅

bye bestie, go converge something gorgeous 🎀🌈🫶