cncf / cncf/mentoring

[CNCF LFX Proposal] Flatcar Container Linux: Cloud-Init to Butane YAML config transpiler

Open
#1,964 19 comments 0 reactions 0 assignees View on GitHub
2026 CNCF Approved Exported lfx mentorship Maintainer/Contribex Approved Mentors Confirmed Proposal Term 3: Sept-Nov Validation Passed
Dominant language
JavaScript
Stars
3.1k
Forks
816
Avg merge
12h 32m
Merged PRs (30d)
8

Description

### CNCF Project

Flatcar Container Linux

### Term

2026 Term 3 (Sep-Nov)

### Program Name

Cloud-Init to Butane YAML config transpiler

### Program Description

This is a software development project (Go language) for transpiling from one well-defined YAML format (cloud-config) into another (butane). The project aims to implement the minimum functionality necessary to support ClusterAPI worker node provisioning. This limits the transpiler's scope to support only basic Butane features (users, groups, certificates, files, systemd units, etc.).

While the project itself is well scoped and both formats the transpiler is supposed to work with are well defined, it exists in a complex environment of Linux OS operations and OS provisioning.

Mentors are aware and will give support and guidance, in particular with:
- scope, goals, and non-goals
- on-boarding, development loop, and local testing
- integration with Flatcar and ClusterAPI

### Technologies

Go, YAML, ClusterAPI, Linux Based OS

### Skills same as Technologies?

- [x] Yes, the required skills are the same as the technologies listed above.

### Required/Desirable Skills

_No response_

### Mentors

Mathieu Tortuyaux | @tormath1 | mathieu.tortuyaux@gmail.com | TortueMat
Thilo Fromm | @t-lo | thilo.fromm.work@gmail.com | t-lo
Michael McCune | @elmiko | msm@opbstudios.com | elmiko

### Upstream Issue URL

https://github.com/flatcar/Flatcar/issues/2226

### Application Prerequisites

- [x] Resume
- [x] Cover Letter
- [ ] School Enrollment Verification
- [ ] Participation Permission from school or employer
- [ ] Coding Challenge
- [ ] Custom Prerequisite (fill in details below)

### Coding Challenge URL

_No response_

### Custom Prerequisite Name

_No response_

### Custom Prerequisite Description

_No response_

### Custom Prerequisite — File Upload

- [ ] Yes — completion of this task requires the mentee to submit a file.

---
**LFX program:** [CNCF - Flatcar Container Linux: Cloud-Init to Butane YAML config transpiler (2026 Term 3)](https://mentorship.lfx.linuxfoundation.org/project/5245ead5-180e-4117-92cd-1d3ec075ed97)

Contributor guide

Open the contributing guide

Research direction

Start with the upstream Flatcar issue #2226 and read the cloud-config and Butane format requirements for ClusterAPI worker-node provisioning. Use the stated minimum scope—users, groups, certificates, files, and systemd units—to define acceptance cases; done means a Go transpiler handles those cases and is locally tested with mentor guidance.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, linux, yaml
Domain
cloud, devops, operating-systems
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.