Skip to content

Chef configuration management repo for configuring & maintaining the OpenStreetMap servers.

License

Notifications You must be signed in to change notification settings

openstreetmap/chef

Folders and files

NameName
Last commit message
Last commit date

Latest commit

5e68410 · Jan 11, 2025
Dec 3, 2024
Jan 11, 2025
Aug 24, 2023
Jan 10, 2025
Dec 3, 2024
May 29, 2019
Nov 6, 2019
Feb 1, 2021
Dec 23, 2024
Dec 8, 2019
Feb 13, 2023
May 14, 2021
Aug 24, 2023
Aug 29, 2023
Oct 12, 2022
Oct 25, 2024
Oct 25, 2024
Feb 11, 2018
Aug 24, 2023

Repository files navigation

OpenStreetMap chef cookbooks

Cookstyle Test Kitchen

This repository manages the configuration of all the servers run by the OpenStreetMap Foundation's Operations Working Group. We use Chef to automated the configuration of all of our servers.

OSMF Operations Working Group

Roles

We make extensive use of roles to configure the servers. In general we have:

Server-specific roles (e.g. faffy.rb)

These deal with particular setup or quirks of a server, such as its IP address. They also include roles representing the service they are performing, and the location they are in and any particular hardware they have that needs configuration. All our servers are named after dragons.

Hardware-specific roles (e.g. hp-g9.rb)

Covers anything specific to a certain piece of hardware, like a motherboard, that could apply to multiple machines.

Location-specific roles (e.g. equinix-dub.rb)

These form a hierarchy of datacentres, organisations, and countries where our servers are located.

Service-specific roles (e.g. web-frontend)

These cover the services that the server is running, and will include the recipes required for that service along with any specific configurations and other cascading roles.

Cookbooks

We use the 'Organization Repository' approach, where we have all our cookbooks in this repository (as opposed to one repository per cookbook). Additionally we don't make use of external cookbooks so every cookbook required is in this repository.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for more details. The guide also includes details on how to run the tests locally.

Contact Us