Compare commits

..
Author SHA1 Message Date
Marcus Noble 25186c75b9 fix: RSS feed description contains only article content, not full page
Extract just the <article> element (title + body) for feed descriptions,
removing header, navigation, share buttons, and footer.
2026-11-16 15:29:02 +00:00
Marcus Noble 334fa146c7 fix: RSS feed includes full post content instead of summary only
- Extract body content from rendered HTML for feed descriptions
- Feed readers will now see full post content, not just front-matter summary
2026-11-16 15:26:01 +00:00
Marcus Noble 06a50db987 fix: add feed GUIDs and match production URL format
- Add <guid> elements to RSS feed (matching <link> URLs)
- Preserve dots in slugs (t.i.l. instead of til) to match production
- URLs now match production format: /YYYY-MM-DD-title-slug/
  No /posts/ prefix, with dots preserved for T.I.L. posts
- This ensures feed readers won't mark posts as new
2026-11-16 13:35:16 +00:00
Marcus Noble 63a171aefd fix: match production URL format and fix OG URL
- Use front-matter title for post slug (not filename)
- Remove /posts/ prefix from URLs to match production
- Remove /pages/ prefix from page URLs to match production
- Fix OG URL on index page (no longer shows .html extension)
- Remove dots from slugs (fixes T.I.L. posts being files not dirs)
- Collapse consecutive dashes in slugs
- Remove / from slug character class (prevents URL paths in slugs)
- Skip index.html in permalink plugin (already has correct path from pagination)

Production URL format: /YYYY-MM-DD-full-title-slug/
2026-11-16 12:15:05 +00:00
Marcus Noble b21390b1a4 fix: use @metalsmith/collections v2 sort API for descending post order
The v2 API uses sort: 'date:desc' instead of sortBy: 'date' + reverse:
true. This ensures posts display newest-first on the index page.
2026-11-16 11:10:33 +00:00
Marcus Noble b547cd3137 fix: copy static CSS files (pico.min.css, zenburn.css) to build
The .ignore(['css']) pattern was preventing all CSS files in src/css/
from being copied to the build directory. Only SCSS source files should
be ignored - pre-compiled CSS dependencies like pico.min.css and
zenburn.css need to be served by the static file server.
2026-11-16 11:04:31 +00:00
Marcus Noble 7a5c031b1d feat: modernize static site generator stack
- Node.js: Upgraded from v16 to v22 (latest LTS)
- SASS: Replaced deprecated node-sass with Dart Sass (sass package)
- Metalsmith plugins: Migrated to modern scoped packages:
  - @metalsmith/markdown (v1.10) replacing metalsmith-markdownit
  - @metalsmith/in-place (v5) replacing metalsmith-in-place v1
  - @metalsmith/layouts (v3) replacing metalsmith-layouts v1
  - @metalsmith/collections (v2) replacing metalsmith-collections v0
  - Added metalsmith-define for site metadata
  - Added gray-matter for YAML front matter extraction
- Markdown rendering: Updated to marked v18 for GFM support
- Express: Kept at v4.x (stable, compatible)
- Handlebars: Updated to v4.7 (latest)
- Custom plugins: Created local permalinks and handlebars-html plugins
  - Custom permalinks plugin replaces metalsmith-permalinks (broken substitute dep)
  - Custom handlebars jstransformer wrapper supports .html extension
- Feed generation: Custom RSS plugin (replaces deprecated metalsmith-feed)
- filterRoutes: Updated regex patterns for Express compatibility
- Template changes: Removed deprecated markdown="1" from partials
- Docker: Updated Dockerfile to use Node 22 Alpine
- Collection patterns: Updated to support both .md and .markdown extensions
- Pipeline: Reordered for correct metadata flow (front matter → markdown → layouts → permalinks)
2026-11-16 10:39:12 +00:00
AverageMarcus 35e9dfe24b Fix hr style on mobile
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2026-11-16 07:12:44 +00:00
AverageMarcus 9d75020029 Fix hr styling
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2026-11-16 07:09:04 +00:00
AverageMarcus 28b072bcf2 Added blog posts from Adriana Villela
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2026-05-24 08:22:27 +01:00
AverageMarcus 9a1ccec281 Updated recommended kubernetes resources post
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2026-05-23 10:54:46 +01:00
AverageMarcus cb324f6540 Updated KubeCon post
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2026-03-20 08:20:57 +00:00
AverageMarcus ccea55348a Fix post tags
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2026-03-17 20:38:06 +00:00
AverageMarcus 4b5b061e49 Update image
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2026-03-17 20:37:07 +00:00
AverageMarcus 6d441544cd Added KubeCon EU guide post
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2026-03-17 20:24:50 +00:00
AverageMarcus f77d618553 Block more bad bot activity
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2025-09-28 16:22:24 +01:00
AverageMarcus c4263762c7 Added 'investigating-and-fixing-stoppodsandbox' post
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2025-09-28 12:17:11 +01:00
AverageMarcus 1a9df45e55 Added advice from Josh Clark
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2025-05-10 17:14:00 +01:00
AverageMarcus d5d7f74fd0 Added some advice from lobste.rs
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2025-05-03 07:11:07 +01:00
AverageMarcus 934c4f4de3 Added advice from Aaron Patterson
Signed-off-by: Marcus Noble <github@marcusnoble.co.uk>
2025-05-03 07:04:38 +01:00
17 changed files with 1401 additions and 237 deletions

No files matched your search

+1 -1
View File
@@ -1 +1 @@
16
22
+2 -2
View File
@@ -1,11 +1,11 @@
FROM node:16.17-alpine
FROM node:22-alpine
RUN apk update && apk add python3 make gcc g++
WORKDIR /app
ADD package.json .
RUN npm install
RUN npm install --production
ADD . .
+482 -137
View File
@@ -1,177 +1,522 @@
"use strict";
const fs = require('fs');
const https = require('https');
const express = require('express');
const compress = require('compression');
const app = express();
const Metalsmith = require('metalsmith');
const inplace = require('metalsmith-in-place');
const layouts = require('metalsmith-layouts');
const markdown = require('metalsmith-markdownit');
const permalinks = require('metalsmith-permalinks');
const collections = require('metalsmith-collections');
const pagination = require('metalsmith-pagination');
const define = require('metalsmith-define');
const feed = require('metalsmith-feed');
const sass = require('metalsmith-sass');
const date = require('metalsmith-build-date');
const sitemap = require('metalsmith-sitemap');
const Handlebars = require('handlebars');
const emoji = require('markdown-it-emoji');
const moment = require('moment');
const striptags = require('striptags');
const fs = require("fs");
const path = require("path");
const express = require("express");
const compress = require("compression");
const Metalsmith = require("metalsmith");
const matter = require("gray-matter");
const inPlace = require("@metalsmith/in-place");
const layouts = require("@metalsmith/layouts");
const markdown = require("@metalsmith/markdown");
const permalinks = require("./plugins/permalinks");
const collections = require("@metalsmith/collections");
const pagination = require("metalsmith-pagination");
const define = require("metalsmith-define");
const sitemap = require("metalsmith-sitemap");
const Handlebars = require("handlebars");
const moment = require("moment");
const striptags = require("striptags");
const { marked } = require("marked");
const RSS = require("rss");
const sass = require("sass");
const port = process.env.PORT || 8000;
app.disable('x-powered-by');
const app = express();
app.disable("x-powered-by");
app.use(compress());
app.use(express.static(__dirname + '/build'));
app.use(express.static(__dirname + "/build"));
// Lets try and slow down some of those exploit crawlers
app.use("/", require('./filterRoutes'));
app.use("/", require("./filterRoutes"));
// Redirects
app.use("/", require('./redirects'));
app.use("/", require("./redirects"));
// Handle some iOS icon 404s
app.get("/apple-touch-icon*", function(req, res) {
res.sendFile(__dirname + '/build/images/favico/' + req.url, () => {
res.sendFile(__dirname + '/build/images/favico/apple-touch-icon.png');
app.get("/apple-touch-icon*", function (req, res) {
res.sendFile(__dirname + "/build/images/favico/" + req.url, () => {
res.sendFile(__dirname + "/build/images/favico/apple-touch-icon.png");
});
});
app.get("/images/favico/*.png", function(req, res) {
res.sendFile(__dirname + '/build/images/favico/apple-touch-icon.png');
app.get("/images/favico/*.png", function (req, res) {
res.sendFile(__dirname + "/build/images/favico/apple-touch-icon.png");
});
app.get("/favicon.png", function(req, res) {
res.sendFile(__dirname + '/build/images/favico/apple-touch-icon.png');
app.get("/favicon.png", function (req, res) {
res.sendFile(__dirname + "/build/images/favico/apple-touch-icon.png");
});
app.get("/robots.txt", function(req, res) {
app.get("/robots.txt", function (req, res) {
res.send("User-agent: * Disallow: ");
})
app.get(/(\/(feeds?|rss|atom)\/?|feed.xml|rss.xml|index.rss|feed.rss)$/, function(req, res) {
res.redirect(301, '/feed.xml');
});
app.get(/.+\/manifest.json$/, function(req, res) {
res.redirect(301, '/manifest.json');
app.get(
/\/(feeds?|rss|atom)\/?|feed\.xml|rss\.xml|index\.rss|feed\.rss$/,
function (req, res) {
res.redirect(301, "/feed.xml");
}
);
app.get(/.+\/manifest\.json$/, function (req, res) {
res.redirect(301, "/manifest.json");
});
app.get("/healthz", function(req, res) {
app.get("/healthz", function (req, res) {
res.sendStatus(200);
});
var md = markdown({html: true});
md.parser.use(emoji);
const proxy = (tokens, idx, options, env, self) => self.renderToken(tokens, idx, options);
const defaultTableOpenRenderer = md.parser.renderer.rules.table_open || proxy;
md.parser.renderer.rules.table_open = function(tokens, idx, options, env, self) {
tokens[idx].attrJoin("role", "grid");
return defaultTableOpenRenderer(tokens, idx, options, env, self)
// --- Markdown renderer setup ---
marked.setOptions({
gfm: true,
breaks: true,
});
const renderer = new marked.Renderer();
// Custom table renderer to add role="grid" (matches original behavior)
const originalTable = renderer.table.bind(renderer);
renderer.table = function (e) {
let result = originalTable(e);
return result.replace("<table>", '<table role="grid">');
};
Handlebars.registerHelper('markdown', function(text) {
if(!text) return;
return md.parser.render(text);
const customRenderer = (source, _opts, _context) => {
return marked.parse(source, { renderer });
};
// --- Handlebars helpers ---
Handlebars.registerHelper("markdown", function (text) {
if (!text) return;
return customRenderer(text, {}, {});
});
Handlebars.registerHelper('moment', function(date, format) {
Handlebars.registerHelper("moment", function (date, format) {
return new moment(date).format(format);
});
Handlebars.registerHelper("striptags", function(text){
return striptags(text);
Handlebars.registerHelper("striptags", function (text) {
return striptags(text);
});
Handlebars.registerHelper("buildTitle", function(title, siteTitle){
if (title.indexOf(siteTitle) < 0) {
title = `'${title}' by ${siteTitle}`;
Handlebars.registerHelper("buildTitle", function (title, siteTitle) {
if (title.indexOf(siteTitle) < 0) {
title = "'" + title + "' by " + siteTitle;
}
return title;
});
Handlebars.registerHelper("jointags", function(tags){
return (tags || '').split(' ').join(',');
Handlebars.registerHelper("jointags", function (tags) {
return (tags || "").split(" ").join(",");
});
Handlebars.registerHelper("encodetitle", function(str){
return (str || '').replaceAll(' ', '%2B');
Handlebars.registerHelper("encodetitle", function (str) {
return (str || "").replaceAll(" ", "%2B");
});
Metalsmith(__dirname)
.use(define({
site: {
title: 'Marcus Noble',
description: 'The blog of Marcus Noble, self-described tinkerer, platform engineer and all round average guy!',
url: 'https://marcusnoble.co.uk'
}
}))
.use(date())
.use(collections({
posts: {
pattern: 'posts/*',
sortBy: 'date',
reverse: true,
},
drafts: {
pattern: 'drafts/*',
sortBy: 'date',
reverse: true,
},
projects: {
pattern: 'projects/*'
},
pages: {
pattern: 'pages/*'
}
}))
.use(inplace({
engine: 'handlebars',
directory: 'templates',
partials: 'templates/partials'
}))
.use(md)
.use(permalinks({
pattern: ':date-:title',
date: 'YYYY-MM-DD',
linksets: [
{
match: { collection: 'pages' },
pattern: ':title'
},
{
match: { collection: 'drafts' },
pattern: 'drafts/:title'
}
]
}))
.use(feed({
collection: 'posts',
destination: 'feed.xml'
}))
.use(sitemap({
hostname: 'https://marcusnoble.co.uk',
modifiedProperty: 'date'
}))
.use(pagination({
'collections.posts': {
perPage: 5,
layout: 'index.html',
first: 'index.html',
noPageOne: true,
path: 'page:num/index.html',
pageMetadata: {
title: 'Posts'
}
}
}))
.use(layouts({
engine: 'handlebars',
directory: 'templates',
partials: 'templates/partials'
}))
.use(sass())
.build(function(err) {
if (err) throw err;
// --- Pre-build: Compile SCSS to CSS ---
function compileSass(sourceDir, outputDir) {
const cssDir = path.join(sourceDir, "src", "css");
const outputCssDir = path.join(outputDir, "css");
app.listen(port, function () {
console.log(`App listening at http://localhost:${port}`);
if (!fs.existsSync(cssDir)) {
console.warn("No CSS source directory found, skipping SCSS compilation");
return;
}
// Ensure output directory exists
if (!fs.existsSync(outputCssDir)) {
fs.mkdirSync(outputCssDir, { recursive: true });
}
const files = fs.readdirSync(cssDir);
fs.mkdirSync(outputCssDir, { recursive: true });
for (const file of files) {
if (!file.endsWith(".scss") || file.startsWith("_")) continue; // Skip partials
const inputPath = path.join(cssDir, file);
const outputFileName = file.replace(/\.scss$/, ".css");
const outputPath = path.join(outputCssDir, outputFileName);
console.log(`Compiling SCSS: ${file} -> ${outputFileName}`);
try {
const result = sass.compile(inputPath, {
style: "compressed",
});
fs.writeFileSync(outputPath, result.css);
} catch (err) {
console.error(`Failed to compile ${file}:`, err.message);
throw err;
}
}
}
// --- Feed generation plugin ---
function feedPlugin() {
return function (files, metalsmith, done) {
const posts = metalsmith.metadata().collections.posts || [];
const feed = new RSS({
title: "Marcus Noble",
description:
"The blog of Marcus Noble, self-described tinkerer, platform engineer and all round average guy!",
site_url: "https://marcusnoble.co.uk",
feed_url: "https://marcusnoble.co.uk/feed.xml",
image_url: "https://marcusnoble.co.uk/images/marcus.jpg",
language: "en",
});
posts.forEach((post) => {
const postUrl = `https://marcusnoble.co.uk/${post.path}/`;
// Find the rendered HTML content for this post
// post.path is the permalink path (e.g., 2026-03-17-kubecon-...), files use /index.html
const contentKey = post.path + '/index.html';
let renderedContent = "";
if (files[contentKey]) {
const fullHtml = files[contentKey].contents.toString();
// Extract just the post content (not header/footer/navigation)
// Match the article element which contains the actual post content
const articleMatch = fullHtml.match(/<article[^>]*>([\s\S]*?)<\/article>/i);
renderedContent = articleMatch ? articleMatch[1].trim() : fullHtml;
}
feed.item({
title: post.title,
url: postUrl,
guid: postUrl,
date: post.date.toISOString(),
description: renderedContent || post.summary || "",
categories: (post.tags || "").split(" ").filter(Boolean),
});
});
files["feed.xml"] = {
contents: Buffer.from(feed.xml({ indent: true })),
modified: new Date(),
};
done();
};
}
// --- Handlebars partials preprocessor ---
// Processes {{> partial }} calls in markdown files before markdown rendering
function handlebarsPreprocessor() {
return function (files, metalsmith, done) {
const templateDir = path.join(metalsmith.directory(), "templates");
const partialsDir = path.join(templateDir, "partials");
// Load all partials
const hbs = Handlebars.create();
hbs.registerHelper("markdown", function (text) {
if (!text) return "";
return customRenderer(text, {}, {});
});
hbs.registerHelper("moment", function (date, format) {
return new moment(date).format(format);
});
hbs.registerHelper("striptags", striptags);
hbs.registerHelper("buildTitle", function (title, siteTitle) {
if (title.indexOf(siteTitle) < 0) {
title = "'" + title + "' by " + siteTitle;
}
return title;
});
hbs.registerHelper("jointags", function (tags) {
return (tags || "").split(" ").join(",");
});
hbs.registerHelper("encodetitle", function (str) {
return (str || "").replaceAll(" ", "%2B");
});
// Register all partials
if (fs.existsSync(partialsDir)) {
const partialFiles = fs.readdirSync(partialsDir);
for (const file of partialFiles) {
const name = path.parse(file).name;
const content = fs.readFileSync(path.join(partialsDir, file), "utf8");
hbs.registerPartial(name, content);
}
}
// Find markdown files with partial references and process them
const filesToProcess = Object.keys(files).filter((file) =>
file.endsWith(".md") || file.endsWith(".markdown")
);
for (const file of filesToProcess) {
const content = files[file].contents.toString();
const handlebarsRegex = /\{\{\s*>\s*(\w+)\s+([^}]*)\s*\}\}/g;
const matches = [...content.matchAll(handlebarsRegex)];
if (matches.length > 0) {
let processed = content;
for (const match of matches) {
const partialName = match[1];
const argsStr = match[2];
// Parse arguments: name="value" name="value" ...
const args = {};
const argRegex = /(\w+)=["']([^"']*)["']/g;
let argMatch;
while ((argMatch = argRegex.exec(argsStr)) !== null) {
args[argMatch[1]] = argMatch[2];
}
try {
const partial = hbs.partials[partialName];
if (partial) {
const rendered = hbs.compile(partial)(args);
processed = processed.replace(match[0], rendered);
}
} catch (e) {
console.warn(
`Warning: Could not render partial ${partialName} in ${file}`
);
}
}
files[file].contents = Buffer.from(processed);
}
}
// Extract date and title from filename for permalinks compatibility
// The filename date is the primary source for the permalink
const postPattern = /^posts\/(\d{4}-\d{2}-\d{2})-(.+)\.(md|markdown)$/;
for (const file of Object.keys(files)) {
const match = file.match(postPattern);
if (match) {
const [, dateStr, titleSlug] = match;
// Use filename date for permalink (via _filenameDate), but front matter date for other purposes
// Store filename-based date for permalinks
if (!files[file]._filenameDate) {
files[file]._filenameDate = new Date(dateStr);
}
// Also store the filename-based title slug for permalinks
if (!files[file]._filenameTitle) {
files[file]._filenameTitle = titleSlug;
}
// Set the title from front matter (or derive from filename)
if (!files[file].title) {
// Convert slug to title: "some-title-slug" -> "Some Title Slug"
files[file].title = titleSlug
.split("-")
.map((word) => word.charAt(0).toUpperCase() + word.slice(1))
.join(" ");
}
}
// Set default date for files without one (e.g., index.html from pagination, pages)
if (!files[file].date) {
files[file].date = new Date();
}
}
done();
};
}
// --- Metalsmith build pipeline ---
// Pre-build: Compile SCSS to CSS and write to build directory
compileSass(__dirname, path.join(__dirname, "build"));
const ms = Metalsmith(__dirname)
.ignore(['**/*.scss']) // Don't copy SCSS source files to build
.clean(false) // Don't clean build directory (pre-build SCSS compilation outputs preserved)
.source("src")
.use(
define({
site: {
title: "Marcus Noble",
description:
"The blog of Marcus Noble, self-described tinkerer, platform engineer and all round average guy!",
url: "https://marcusnoble.co.uk",
},
})
)
.use(function (files, metalsmith, done) {
const now = new Date();
const meta = metalsmith.metadata();
meta.buildDate = now;
meta.buildTimestamp = now.toISOString();
done();
})
.use(
collections({
posts: {
pattern: "posts/*.{md,markdown}",
sort: "date:desc",
},
drafts: {
pattern: "drafts/*.{md,markdown}",
sort: "date:desc",
},
projects: {
pattern: "projects/*",
},
pages: {
pattern: "pages/*",
},
})
)
.use(function (files, metalsmith, done) {
// Extract YAML front matter from all markdown files
Object.keys(files).forEach(function (file) {
if (file.endsWith(".md") || file.endsWith(".markdown")) {
const content = files[file].contents.toString();
const parsed = matter(content);
// Update file content to body (without front matter)
files[file].contents = Buffer.from(parsed.content);
// Extract front matter as file metadata
if (parsed.data) {
Object.assign(files[file], parsed.data);
}
}
});
done();
})
.use(handlebarsPreprocessor())
.use(
markdown({
render: customRenderer,
})
)
.use(
pagination({
"collections.posts": {
perPage: 5,
layout: "index.html",
first: "index.html",
noPageOne: true,
path: "page:num/index.html",
pageMetadata: {
title: "Posts",
},
},
})
)
.use(function (files, metalsmith, done) {
// Pre-compute paths for layouts rendering
// This mirrors the permalinks logic but doesn't rename files
const slugRe = /[<>:"'\|?*]|[^\w\s$_+~.()!\-@]+/g;
const linksets = [
{ match: { collection: "pages" }, pattern: ":title" },
{ match: { collection: "drafts" }, pattern: "drafts/:title" },
];
for (const file of Object.keys(files)) {
const data = files[file];
// Set default date
if (!data.date) {
data.date = new Date();
}
// Skip non-HTML files
if (!file.endsWith(".html")) continue;
if (data.permalink === false) continue;
// Skip layout files (layout matches filename)
const baseName = path.basename(file, ".html");
// Don't skip index.html - it already has permalink from pagination
if (file === "index.html") {
// Set path for index page (root URL)
data.path = "";
continue;
}
if (data.layout === baseName || data.layout === `${baseName}.html`) continue;
// Determine linkset
let linkset = null;
for (const ls of linksets) {
if (ls.match) {
let matched = true;
for (const [key, val] of Object.entries(ls.match)) {
const fileVal = data[key];
if (Array.isArray(fileVal)) {
if (!fileVal.includes(val)) { matched = false; break; }
} else if (fileVal !== val) { matched = false; break; }
}
if (matched) { linkset = ls; break; }
}
}
const pattern = linkset ? (linkset.pattern || ":date-:title") : ":date-:title";
// Compute permalink
let result = pattern
.replace(/:(\w+)(\??)/g, (match, key, optional) => {
let value = data[key];
if (value === undefined || value === null) {
if (optional) return "";
return key;
}
if (key === "date" && data._filenameDate) {
const d = data._filenameDate;
return d.getFullYear() + "-" + String(d.getMonth() + 1).padStart(2, "0") + "-" + String(d.getDate()).padStart(2, "0");
}
if (value instanceof Date) {
const d = value;
return d.getFullYear() + "-" + String(d.getMonth() + 1).padStart(2, "0") + "-" + String(d.getDate()).padStart(2, "0");
}
return String(value).toLowerCase().replace(/\s+/g, "-").replace(slugRe, "").replace(/-+/g, "-");
})
.replace(/\/+$/, "");
// Add directory index - force index.html for permalinks without .html extension
// Dots in titles (like T.I.L.) confuse path.extname() so we check the actual extension
if (!result.endsWith(".html")) {
result = path.join(result, "index.html");
}
// Post files: no prefix - URLs match production format /YYYY-MM-DD-slug/
data.permalink = result;
// Set path for templates (permalink without index.html)
if (data.permalink.endsWith("/index.html")) {
data.path = data.permalink.replace(/\/index\.html$/, "");
} else if (path.extname(data.permalink) === ".html") {
data.path = data.permalink.replace(/\.html$/, "");
} else {
data.path = data.permalink;
}
}
done();
})
.use(
layouts({
transform: require("./plugins/handlebars-html"),
directory: "templates",
pattern: "**/*.html",
extname: ".html",
})
)
.use(
permalinks({
pattern: ":date-:title",
date: "YYYY-MM-DD",
linksets: [
{
match: { collection: "pages" },
pattern: ":title"
},
{
match: { collection: "drafts" },
pattern: "drafts/:title"
}
]
})
)
.use(
sitemap({
hostname: "https://marcusnoble.co.uk",
omitExtension: true,
})
)
.use(feedPlugin());
// Run the build
ms.build(function (err) {
if (err) {
console.error("Build failed:", err);
throw err;
}
console.log("Build complete. Starting server...");
app.listen(port, function () {
console.log(`App listening at http://localhost:${port}`);
});
});
+66 -66
View File
@@ -1,88 +1,88 @@
const express = require('express');
const express = require("express");
const router = express.Router();
const blackHole = function (req, res) {
res.redirect("https://crawler-test.com/redirects/infinite_redirect");
res.redirect("https://crawler-test.com/redirects/infinite_redirect");
};
// Specifically allow, but mark as not-found, any `/.well-known/` paths
router.all(/^\/\.well-known\//, function(req, res) {
res.sendStatus(404);
router.all(/^\/\.well-known\//, function (req, res) {
res.sendStatus(404);
});
// Block access to any root-level dot files
router.all(/^\/\./, blackHole);
// Block access to file types I don't use
router.all(/.*\.php$/, blackHole);
router.all(/.*\.asp$/, blackHole);
router.all(/.*\.aspx$/, blackHole);
router.all(/.*\.gz$/, blackHole);
router.all(/.*\.bz2$/, blackHole);
router.all(/.*\.tar$/, blackHole);
router.all(/.*\.sql$/, blackHole);
router.all(/.*\.env$/, blackHole);
router.all(/.*\.ini$/, blackHole);
router.all(/.*\.pem$/, blackHole);
router.all(/.*\.key$/, blackHole);
router.all(/.*\.crt$/, blackHole);
router.all(/.*\.properties$/, blackHole);
router.all(/\.php$/, blackHole);
router.all(/\.asp$/, blackHole);
router.all(/\.aspx$/, blackHole);
router.all(/\.gz$/, blackHole);
router.all(/\.bz2$/, blackHole);
router.all(/\.tar$/, blackHole);
router.all(/\.sql$/, blackHole);
router.all(/\.env$/, blackHole);
router.all(/\.ini$/, blackHole);
router.all(/\.pem$/, blackHole);
router.all(/\.key$/, blackHole);
router.all(/\.crt$/, blackHole);
router.all(/\.properties$/, blackHole);
// Block access to any .git folders
router.all(/.*\/\.git\/.*/, blackHole);
router.all(/\/\.git\//, blackHole);
// Block attempts to navigate up directories
router.all(/.*\.\.\/.*/, blackHole);
router.all(/\.\.\//, blackHole);
// Block access to special Mac folder
router.all('/__MACOSX/*?', blackHole);
// Block access to Workdpress files
router.all('(/*)?/wp-admin/', blackHole);
router.all('(/*)?/wp-includes/?(*)?', blackHole);
router.all('(/*)?/wp-content/?(*)?', blackHole);
router.all('/wordpress/', blackHole);
router.all('/wp(2)?/', blackHole);
router.all(/\/__MACOSX\//, blackHole);
// Block access to WordPress files
router.all(/^\/?\/?wp-admin(\/.*)?$/, blackHole);
router.all(/^\/?\/?wp-includes(\/.*)?$/, blackHole);
router.all(/^\/?\/?wp-content(\/.*)?$/, blackHole);
router.all(/\/wordpress\//, blackHole);
router.all(/\/wp2?\//, blackHole);
// Block access to possible databases
router.all('/database/', blackHole);
router.all('/db/', blackHole);
router.all('/db-backup/', blackHole);
router.all('/db_backup/', blackHole);
router.all('/sql-backup/', blackHole);
router.all('/sql/', blackHole);
router.all('/pma/', blackHole);
router.all('/phpmyadmin/', blackHole);
router.all('/mysqladmin/', blackHole);
router.all('/mysql/', blackHole);
router.all('/myadmin/', blackHole);
router.all(/\/database\//, blackHole);
router.all(/^\/db(\/.*)?$/, blackHole);
router.all(/\/db-backup\//, blackHole);
router.all(/\/db_backup\//, blackHole);
router.all(/\/sql-backup\//, blackHole);
router.all(/^\/sql(\/.*)?$/, blackHole);
router.all(/\/pma\//, blackHole);
router.all(/\/phpmyadmin\//, blackHole);
router.all(/\/mysqladmin\//, blackHole);
router.all(/^\/mysql(\/.*)?$/, blackHole);
router.all(/\/myadmin\//, blackHole);
// Block access to possible backups and uploads
router.all('/backup/', blackHole);
router.all('/uploads/', blackHole);
router.all('/test/', blackHole);
router.all('/temp/', blackHole);
router.all(/.*\/dbbackup\/.*/, blackHole);
router.all('/bak/', blackHole);
router.all('archive.zip', blackHole);
router.all(/\/backup(\/.*)?$/, blackHole);
router.all(/\/uploads(\/.*)?$/, blackHole);
router.all(/\/test(\/.*)?$/, blackHole);
router.all(/\/temp(\/.*)?$/, blackHole);
router.all(/\/dbbackup\//, blackHole);
router.all(/\/bak\//, blackHole);
router.all(/archive\.zip$/, blackHole);
// Block access to possible credentials
router.all('/env.test', blackHole);
router.all('/admin(/.*)?', blackHole)
router.all('/credentials(/*)?', blackHole);
router.all(/.*credentials\.json$/, blackHole);
router.all(/.*keys\.json$/, blackHole);
router.all(/.*secrets\.json$/, blackHole);
router.all(/\/env\.test$/, blackHole);
router.all(/^\/?(.*)?\/env$/, blackHole);
router.all(/^\/admin(\/.*)?$/, blackHole);
router.all(/^\/credentials(\/.*)?$/, blackHole);
router.all(/credentials\.json$/, blackHole);
router.all(/keys\.json$/, blackHole);
router.all(/secrets\.json$/, blackHole);
// Block system paths
router.all('/etc/*', blackHole);
router.all('/var/*', blackHole);
router.all('/usr/*', blackHole);
router.all('/user/*', blackHole);
router.all(/\/etc\//, blackHole);
router.all(/\/var\//, blackHole);
router.all(/\/usr\//, blackHole);
router.all(/\/user\//, blackHole);
// Block misc stuff
router.all('/data/owncloud.log', blackHole);
router.all('/autodiscover/autodiscover.xml', blackHole)
router.all('/.well-known/autoconfig(/*)?', blackHole)
router.all('/sites/default/files/', blackHole);
router.all(/.*\/mail\/config-.+\.xml/, blackHole);
router.all('/bitnami/*', blackHole)
router.all('/aws/*', blackHole)
router.all(/\/data\/owncloud\.log$/, blackHole);
router.all(/\/autodiscover\/autodiscover\.xml$/, blackHole);
router.all(/\/\.well-known\/autoconfig(\/.*)?$/, blackHole);
router.all(/\/sites\/default\/files\//, blackHole);
router.all(/\/mail\/config-.+\.xml$/, blackHole);
router.all(/\/bitnami\//, blackHole);
router.all(/\/aws\//, blackHole);
// Block methods I don't support
router.post('*', blackHole);
router.put('*', blackHole);
router.delete('*', blackHole);
router.post("*", blackHole);
router.put("*", blackHole);
router.delete("*", blackHole);
module.exports = router
module.exports = router;
+18 -20
View File
@@ -6,30 +6,28 @@
"watch": "nodemon --exec npm start -e \"md,html,scss,js\" -i \"build\""
},
"dependencies": {
"compression": "^1.6.2",
"express": "^4.13.4",
"handlebars": "^4.0.5",
"markdown-it-emoji": "^1.1.1",
"metalsmith": "^2.1.0",
"metalsmith-build-date": "^0.2.0",
"metalsmith-collections": "^0.7.0",
"metalsmith-define": "^2.0.1",
"metalsmith-feed": "^0.2.0",
"metalsmith-in-place": "^1.4.4",
"metalsmith-layouts": "^1.6.5",
"metalsmith-markdownit": "^0.3.0",
"metalsmith-pagination": "^1.4.0",
"metalsmith-permalinks": "^0.5.0",
"metalsmith-sass": "^2.0.0",
"@metalsmith/collections": "^2.0.0",
"@metalsmith/in-place": "^5.0.0",
"@metalsmith/layouts": "^3.0.0",
"@metalsmith/markdown": "^1.10.0",
"compression": "^1.8.2",
"express": "^4.21.2",
"gray-matter": "^4.0.3",
"handlebars": "^4.7.10",
"jstransformer-handlebars": "^1.2.0",
"marked": "^18.2.0",
"metalsmith-define": "^2.1.3",
"metalsmith-pagination": "^1.5.0",
"metalsmith-sitemap": "^1.2.2",
"moment": "^2.13.0",
"node-sass": "^6.0.0",
"striptags": "^2.1.1"
"moment": "^2.31.0",
"rss": "^1.2.2",
"sass": "^1.108.2",
"striptags": "^3.2.0"
},
"devDependencies": {
"nodemon": "^1.12.1"
"nodemon": "^3.1.0"
},
"engines": {
"node": "16"
"node": "22"
}
}
+99
View File
@@ -0,0 +1,99 @@
const fs = require("fs");
const path = require("path");
const Handlebars = require("handlebars");
const moment = require("moment");
const striptags = require("striptags");
const { marked } = require("marked");
// Setup marked renderer
marked.setOptions({ gfm: true, breaks: true });
const renderer = new marked.Renderer();
const originalTable = renderer.table.bind(renderer);
renderer.table = function (e) {
let result = originalTable(e);
return result.replace("<table>", '<table role="grid">');
};
// Register helpers on Handlebars
Handlebars.registerHelper("markdown", function (text) {
if (!text) return "";
return marked.parse(text, { renderer });
});
Handlebars.registerHelper("moment", function (date, format) {
return new moment(date).format(format);
});
Handlebars.registerHelper("striptags", function (text) {
return striptags(text);
});
Handlebars.registerHelper("buildTitle", function (title, siteTitle) {
if (title.indexOf(siteTitle) < 0) {
title = "'" + title + "' by " + siteTitle;
}
return title;
});
Handlebars.registerHelper("jointags", function (tags) {
return (tags || "").split(" ").join(",");
});
Handlebars.registerHelper("encodetitle", function (str) {
return (str || "").replaceAll(" ", "%2B");
});
// Load all partials from templates/partials directory
const partialsDir = path.join(__dirname, "..", "templates", "partials");
if (fs.existsSync(partialsDir)) {
fs.readdirSync(partialsDir).forEach((file) => {
const name = path.parse(file).name;
const content = fs.readFileSync(path.join(partialsDir, file), "utf8");
Handlebars.registerPartial(name, content);
});
}
// Compile a template file (used by renderFileAsync)
function compile(filePath) {
const template = fs.readFileSync(filePath, "utf8");
return {
fn: Handlebars.compile(template),
dependencies: [],
};
}
// Render a template string with locals
function render(templateStr, opts, locals) {
const template = Handlebars.compile(templateStr);
const output = template(locals);
return { body: output, dependencies: [] };
}
// Render a template file with locals
async function renderFileAsync(filePath, opts, locals) {
const template = fs.readFileSync(filePath, "utf8");
const compiled = Handlebars.compile(template);
const output = compiled(locals);
return { body: output, dependencies: [] };
}
// Assemble the jstransformer interface
const jstransformer = {
name: "handlebars",
inputFormats: ["hbs", "handlebars", "html"],
outputFormat: "html",
compile: function (templateStr) {
const compiled = Handlebars.compile(templateStr);
return { fn: compiled, dependencies: [] };
},
render: function (templateStr, opts, locals) {
return render(templateStr, opts, locals);
},
renderAsync: async function (templateStr, opts, locals) {
return render(templateStr, opts, locals);
},
renderFileAsync: async function (filePath, opts, locals) {
return renderFileAsync(filePath, opts, locals);
},
registerPartial: Handlebars.registerPartial.bind(Handlebars),
registerHelper: Handlebars.registerHelper.bind(Handlebars),
partials: Handlebars.partials,
helpers: Handlebars.helpers,
};
module.exports = jstransformer;
+184
View File
@@ -0,0 +1,184 @@
const path = require("path");
const fs = require("fs");
/**
* Custom Metalsmith permalinks plugin.
* Preserves source directory structure for posts, applies custom patterns for pages.
*/
function permalinks(options) {
const defaultOptions = {
pattern: ":date-:title",
date: {
format: "YYYY-MM-DD",
locale: "en",
},
linksets: [],
slug: {
lowercase: true,
remove: /[<>:"'\|?*]|[^\w\s$_+~.()!\-@\/]+/g,
extend: { ":": "-", "|": "-", "/": "-", "<": "", ">": "" },
},
trailingSlash: false,
directoryIndex: "index.html",
};
const opts = { ...defaultOptions, ...options };
function formatDate(date) {
if (!date || !(date instanceof Date)) return "";
const d = date;
const format = opts.date.format || "YYYY-MM-DD";
return format
.replace("YYYY", d.getFullYear())
.replace("MM", String(d.getMonth() + 1).padStart(2, "0"))
.replace("DD", String(d.getDate()).padStart(2, "0"))
.replace("D", String(d.getDate()))
.replace("H", String(d.getHours()).padStart(2, "0"))
.replace("m", String(d.getMinutes()).padStart(2, "0"))
.replace("s", String(d.getSeconds()).padStart(2, "0"));
}
function slugify(str) {
if (!str) return "";
let s = str.toString();
if (opts.slug.lowercase) s = s.toLowerCase();
if (opts.slug.extend) {
for (const [from, to] of Object.entries(opts.slug.extend)) {
s = s.split(from).join(to);
}
}
// Replace spaces with dashes and remove special chars
s = s.replace(/\s+/g, "-");
if (opts.slug.remove) {
s = s.replace(new RegExp(opts.slug.remove, "g"), "");
}
return s;
}
function replacePattern(pattern, data) {
return pattern.replace(/:(\w+)(\??)/g, (match, key, optional) => {
let value = data[key];
if (value === undefined || value === null) {
if (optional) return "";
throw new Error(
`Could not substitute ':${key}' in pattern '${pattern}', '${key}' is undefined`
);
}
// For date in permalink, use _filenameDate if available (to avoid collisions
// when front matter date differs from filename date)
if (key === 'date' && data._filenameDate) {
return formatDate(data._filenameDate);
}
if (value instanceof Date) {
return formatDate(value);
}
return slugify(value.toString()).replace(/-+/, "-");
});
}
function getMatchedLinkset(data, linksets) {
for (const linkset of linksets) {
if (linkset.match) {
let matched = false;
for (const [key, val] of Object.entries(linkset.match)) {
const fileVal = data[key];
if (Array.isArray(fileVal)) {
if (fileVal.includes(val)) {
matched = true;
}
} else if (fileVal === val) {
matched = true;
} else {
matched = false;
break;
}
}
if (matched) return linkset;
}
}
return null;
}
return function (files, metalsmith, done) {
const keys = Object.keys(files);
for (const file of keys) {
const data = files[file];
// Skip non-HTML files
if (!file.endsWith(".html")) continue;
// Skip if permalink is explicitly disabled
if (data.permalink === false) continue;
// Skip if this is a layout/template file (has layout that matches filename)
// e.g., index.html with layout: 'index.html' should not be permalinked
const baseName = path.basename(file, '.html');
if (data.layout === baseName || data.layout === `${baseName}.html`) continue;
// Determine which linkset to use (or default)
const linkset = getMatchedLinkset(data, opts.linksets) || opts;
const pattern = linkset.pattern || opts.pattern;
// Check file-specific permalink first
if (data.permalink) {
data.permalink = replacePattern(data.permalink, data);
if (opts.trailingSlash) data.permalink = data.permalink.replace(/\/+$/, "");
continue;
}
let sourcePrefix = "";
// Replace pattern placeholders
let result = replacePattern(pattern, data);
// Remove trailing slashes if not desired
if (!opts.trailingSlash) {
result = result.replace(/\/+$/, "");
}
// Add directory index
if (path.extname(result) === "" || path.extname(result) === ".html") {
if (!path.extname(result)) {
result = path.join(result, opts.directoryIndex);
}
}
data.permalink = result;
// Set path metadata for templates (permalink without index.html)
if (data.permalink.endsWith("/index.html")) {
data.path = data.permalink.replace(/\/index\.html$/, "");
} else if (path.extname(data.permalink) === ".html") {
data.path = data.permalink.replace(/\.html$/, "");
} else {
data.path = data.permalink;
}
}
// Now rename files based on permalink metadata
const renames = [];
for (const [file, data] of Object.entries(files)) {
if (!data.permalink) continue;
if (data.permalink === file) continue; // No change needed
renames.push([file, data.permalink]);
}
for (const [oldName, newName] of renames) {
// Create target directory if needed
const targetDir = path.dirname(newName);
if (!fs.existsSync(targetDir)) {
fs.mkdirSync(targetDir, { recursive: true });
}
// Move file
files[newName] = files[oldName];
delete files[oldName];
}
done();
};
}
module.exports = permalinks;
+24 -8
View File
@@ -42,6 +42,17 @@
"Segoe UI Symbol", "Noto Color Emoji";
}
::-moz-selection {
background-color: var(--primary);
color: var(--primary-inverse);
}
::selection {
background-color: var(--primary);
color: var(--primary-inverse);
}
h2 {
margin-bottom: 10px;
}
@@ -155,37 +166,42 @@ code, kbd, pre {
}
hr {
margin: 1em auto;
margin: 2em auto;
padding: 0;
border: 0;
border-top: solid 3px #57688d;
text-align: center;
width: 60%;
position: relative;
overflow: visible;
&::after {
content: "✨";
display: inline-block;
position: absolute;
top: -0.7em;
position: relative;
top: -1em;
padding: 0 5px;
font-size: 2rem;
filter: grayscale(70%);
transform: translateX(-50%);
@media (max-width:768px){
top: -1.2em;
}
}
&::before {
content: ' ';
background-color: var(--background-color);
display: inline-block;
position: absolute;
top: -1.2em;
position: relative;
top: -1.5em;
padding: 0;
width: 50px;
height: 50px;
border-radius: 23px;
transform: translateX(-50%);
transform: translateX(50%);
article & {
background-color: var(--card-background-color) !important;
@@ -193,7 +209,7 @@ hr {
}
}
section:last-of-type hr {
.home section:last-of-type hr {
display: none;
}
Executable → Regular
BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.9 MiB

After

Width:  |  Height:  |  Size: 830 KiB

+22
View File
@@ -0,0 +1,22 @@
var module=module?module:{};
function hljsDefinePromQL(hljs){
const terms = ['avg', 'bottomk', 'count', 'count_values', 'group', 'limitk', 'limit_ratio', 'max', 'min', 'quantile', 'stddev', 'stdvar', 'sum', 'topk', 'abs', 'absent', 'absent_over_time', 'acos', 'acosh', 'asin', 'asinh', 'atan', 'atanh', 'avg_over_time', 'ceil', 'changes', 'clamp', 'clamp_max', 'clamp_min', 'cos', 'cosh', 'count_over_time', 'days_in_month', 'day_of_month', 'day_of_week', 'day_of_year', 'deg', 'delta', 'deriv', 'exp', 'floor', 'histogram_avg', 'histogram_count', 'histogram_fraction', 'histogram_quantile', 'histogram_sum', 'histogram_stddev', 'histogram_stdvar', 'double_exponential_smoothing', 'hour', 'idelta', 'increase', 'info', 'irate', 'label_replace', 'label_join', 'last_over_time', 'ln', 'log10', 'log2', 'mad_over_time', 'max_over_time', 'min_over_time', 'ts_of_max_over_time', 'ts_of_min_over_time', 'ts_of_last_over_time', 'minute', 'month', 'pi', 'predict_linear', 'present_over_time', 'quantile_over_time', 'rad', 'rate', 'resets', 'round', 'scalar', 'sgn', 'sin', 'sinh', 'sort', 'sort_desc', 'sort_by_label', 'sort_by_label_desc', 'sqrt', 'stddev_over_time', 'stdvar_over_time', 'sum_over_time', 'tan', 'tanh', 'time', 'timestamp', 'vector', 'year', 'on', 'ignoring', 'group_left', 'group_right', 'start()', 'end()', 'by', 'without', 'nan', 'inf'];
const DURATION_MODE = {
scope: 'number',
match: new RegExp(`\\d+[${['y','w','d','h','m','s','ms'].join()}]`)
};
return {
name: "PromQL",
aliases: "promql prom prometheus",
keywords: terms,
contains: [
hljs.COMMENT('#', '$'),
hljs.QUOTE_STRING_MODE,
DURATION_MODE,
hljs.NUMBER_MODE
]
};
}
module.exports=function(hljs){hljs.registerLanguage('promql',hljsDefinePromQL)};
module.exports.definer=hljsDefinePromQL;
@@ -13,6 +13,10 @@ summary: |
<details>
<summary>Changelog</summary>
2026-05-24: Added blog posts from Adriana Villela
2026-05-23: Added iximiuz Labs, Cloud Native Days and CloudNative.Now
2024-06-24: Added links to video channels DevOpsToolkit, You Choose and Enlightning. Added link to KubeHuddle conference.
</details>
@@ -49,11 +53,16 @@ The following might not be quite beginner friendly and should be picked up after
## 🔗 Websites / Blog Posts / Tutorials
* [Official Kubernetes tutorials](https://kubernetes.io/docs/tutorials/kubernetes-basics/)
* [iximiuz Labs](https://labs.iximiuz.com) - Hands-on tutorials, courses and challenges with an interactive Kubernetes environment for you to use all in the browser.
* If you want a real deep dive my buddy [Márk](https://bsky.app/profile/sagikazarmark.com) has built as course: [Kubernetes the (Very) Hard Way](https://labs.iximiuz.com/courses/kubernetes-the-very-hard-way-0cbfd997)
* [Civo Learn](https://www.civo.com/learn) - Tutorials
* [Civo Academy](https://www.civo.com/academy) - A series of workshops to help beginners learn Kubernetes
* [Kube Academy](https://kube.academy/) from VMWare has a lot of tutorials to follow
* [Pluralsight](https://www.pluralsight.com) - if you have a subscription there's several good classes on here related to Kubernetes. I can recommend the ones by [Nigel Poulton](https://nigelpoulton.com/).
* I've previously written a blog post, [Managing Kubernetes without losing your cool](/2022-07-04-managing-kubernetes-without-losing-your-cool/), that has some tools and tips I recommend for everyone working with Kubernetes.
* [Adriana Villela](https://www.linkedin.com/in/adrianavillela/) wrote a couple fantastic, detailed blog posts when initially learning Kubernetes:
* [Just-in-Time Kubernetes: A Beginner’s Guide to Understanding Kubernetes Core Concepts](https://medium.com/dzerolabs/just-in-time-kubernetes-a-beginners-guide-to-kubernetes-core-concepts-19ee7acbafa1)
* [Just-in-Time Kubernetes: Namespaces, Labels, Annotations, and Basic Application Deployment](https://medium.com/dzerolabs/just-in-time-kubernetes-namespaces-labels-annotations-and-basic-application-deployment-f62568a9eaaf)
## 📺 Videos
@@ -69,12 +78,14 @@ The following might not be quite beginner friendly and should be picked up after
* KubeCon + CloudnativeCon is great for meeting people in the community if you have a chance to attend. There are events available in [North America](https://events.linuxfoundation.org/kubecon-cloudnativecon-north-america/), [Europe](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe-2025/), [China](https://events.linuxfoundation.org/kubecon-cloudnativecon-open-source-summit-ai-dev-china/) and [India](https://events.linuxfoundation.org/kubecon-cloudnativecon-india/)
* I'm a huge fan of [Kubernetes Community Days](https://www.cncf.io/kcds/)! These are smaller, local Kubernetes conferences hosted all over the world.
* There's also various [Cloud Native Days](https://cloudnativedays.org) around the world that are similar to KCDs and very community focussed.
* [Cloud Native Rejekts](https://cloud-native.rejekts.io/) is recent favourite of mine and is set up as the "b-side" conference to KubeCon. This great, community focussed conference runs for 2 days before the main KubeCon conference.
* [KubeHuddle](https://kubehuddle.com/) - a wonderful community focussed conference
## 📰 Newsletters
* [KubeWeekly](https://www.cncf.io/kubeweekly/) from CNCF
* [CloudNative.Now](https://cloudnative.now) - This is my monthly newsletter where I do a roundup of everything going on in the cloud native space in the past month. Lots of Kubernetes resources show up in here.
---
@@ -11,6 +11,12 @@ summary: |
<details>
<summary>Changelog</summary>
2025-05-10: Added advice from Josh Clark
2025-05-03: Added some advice from Lobste.rs comments
2025-05-03: Added advice from Aaron Patterson about repeating questions back
2025-05-01: Added advice from Márk Sági-Kazár
2025-05-01: Added suggestion from Oriel about going to the toilet before speaking.
@@ -65,6 +71,14 @@ I also recommend having a final slide with links to get a copy of your slides if
Always remember that **your slides are only there to reenforce what you're saying** and are not the total content. They should enhance and summarise your points as you go so keep them brief and snappy.
On a similar note to avoiding paragraphs, [stip](https://lobste.rs/~stip) points out on [lobste.rs](https://lobste.rs/s/ioyjfm/my_tips_on_giving_technical_talks#c_jixtpt) that:
> you should limit code on slides as much as possible, ideally only to a few lines. In my opinion, most points can be made with just a function signature or a several-line toy function. Showing the audience more than that risks losing them while they try to figure out what is going on.
> If you really need to put a long function on a slide, try and highlight the relevant section as you’re talking about it so the audience can follow along better.
This is great advice! Techies in the audience will automatically try and read all the code and figure out what it does rather than listen to you talking. For this I like to use contrast of text colour to highlight the bits I want people to focus on and "fade out" the rest of the code that is just boiler plate or will be relevant later. I will often have the same code on multiple slides but each slide highlights a different bit of the code so I can walk the audience through it rather than dumping it on them all in one go.
### Technical
Most presentation software has the ability to write **speakers notes**. I don't personally use these myself as I can't read fast enough to make them useful but if you feel more confident with them then I totally recommend using them. The main thing to keep in mind though is not to use them as a script but rather just short notes to remind you of your place in the talk.
@@ -120,6 +134,10 @@ Be aware that you don't need to be all knowing - if you don't have an answer for
If you think an answer might require considerable time or be confusing to explain from the stage then suggest that the person asking the question meets you after the session to discuss it further.
One thing [Aaron Patterson pointed out on Bluesky](https://bsky.app/profile/tenderlove.dev/post/3lo7btf5gfs2u) that I hadn't included here is:
> during Q&A try to repeat the questions. Audience members don't always have a mic so repeating will help everyone, it makes sure you understand the Q, and buys you time to think of an answer
## After the talk
So, you did it! You gave the talk! Congratulations! 🎉
@@ -193,3 +211,21 @@ Bigger is always better here. Assume the person sat at the back of the room also
> Disable true tone (sometimes it makes screen recording yellowish)
Solid practical tip if you use true tone on your machine. Not something I've ever thought of before.
### [tomhukins](https://lobste.rs/~tomhukins) on [lobste.rs](https://lobste.rs/s/ioyjfm/my_tips_on_giving_technical_talks#c_dklog7)
> In one of my talks, I completely forgot what I wanted to say. I noticed myself panicking, so took a deep breath, paused and looked at the audience. When I watched the video of my talk, it looked like a natural pause in the presentation. Although saying “um” as a pause is okay, silence works better.
> I’m a native English speaker and I often present to people who aren’t. I try to speak slowly and clearly, and to use simple or common words whenever possible. I want to communicate an idea, not to sound clever.
> Sharing links and contact details on a final slide makes sense: include a QR code for the audience to photograph.
### [Josh Clark](https://www.linkedin.com/in/je-clark/) on [LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7323429734250418176?commentUrn=urn%3Ali%3Acomment%3A%28activity%3A7323429734250418176%2C7326995404191870977%29&dashCommentUrn=urn%3Ali%3Afsd_comment%3A%287326995404191870977%2Curn%3Ali%3Aactivity%3A7323429734250418176%29)
> In demos, make sure the relevant info (e.g. terminal commands) is in the middle third of the screen. The top of the projector screen can often be washed out or reflecting the overhead lights in the room, and the bottom is often cut off by people's heads.
This is actually really good advice for all your slides. Having padding around the edges of your presentation theme will help you deal with this issue and any wonky projector issues that you might face.
> And when I'm juggling multiple windows (slides, terminal, wireshark, etc) in a presentation, I like to set them up in individual virtual desktops on my mac. In rehearsals, I make sure the order of those desktops is conducive to swiping between them.
This is a great practical tip for how to handle the "cleaning your desktop" advice I have above! Much slicker than moving around windows or finding the appropriate tab or whatever.
@@ -0,0 +1,278 @@
---
layout: post.html
date: 2025-09-28
title: Investigating and fixing "StopPodSandbox from runtime service failed" Kubelet errors
tags: Kubernetes Kubelet CNI
summary: |
For months now (maybe years, who knows 🤷) I've had the following error sprinkled throughout my Kubelet logs across multiple of my worker nodes:
```plain
StopPodSandbox from runtime service failed: rpc error: code = Unknown desc = failed to destroy network for sandbox "055b221e44a28ce8d9120f771d5e1ef201f2457ce49c58999a0147104cca2708": failed to get network "cbr0" cached result: decoding version from network config: unexpected end of JSON input
```
As there has never been any associated impact with this that I could see I just ignored it... for a long time!
Well, fast forward to last Friday night where a sudden hyper-focus hit and I decided I wanted to know what was going on and how to stop it - here's how it went.
---
For months now (maybe years, who knows 🤷) I've had the following error sprinkled throughout my Kubelet logs across multiple of my worker nodes:
```plain
StopPodSandbox from runtime service failed: rpc error: code = Unknown desc = failed to destroy network for sandbox "055b221e44a28ce8d9120f771d5e1ef201f2457ce49c58999a0147104cca2708": failed to get network "cbr0" cached result: decoding version from network config: unexpected end of JSON input
```
As there has never been any associated impact with this that I could see I just ignored it... for a long time!
Well, fast forward to last Friday night where a sudden hyper-focus hit and I decided I wanted to know what was going on and how to stop it - here's how it went.
## A little context
Before we dive into things I think it's worth providing a bit of context first so we all know what we're working with. The Kubernetes cluster in question is my "homelab" cluster that is running [Talos Linux](https://www.talos.dev) within a [Proxmox](https://www.proxmox.com/en/) cluster. The cluster has a single control plane node and 5 worker nodes. The worker nodes are where we'll be focussing. Beyond that there's nothing too special about this cluster. CNI is provided by [Flannel](https://github.com/flannel-io/flannel) with default configuration. The only thing that is kinda unusual is my use of [SMB for my CSI driver](https://github.com/kubernetes-csi/csi-driver-smb) - I only mention this because it's possible that a failure here _might_ have been the thing that trigger the initial issue but I don't know for sure.
## Identifying the issue
As I sad, I had ignored this for months and not thought much of it until Friday. I was cleaning up some unrelated stuff in my cluster and was checking my Kubelet logs stored in [Loki](https://grafana.com/docs/loki/latest/) to see if my cleaning up had been applied. This is how I (re-)noticed the high number of sandbox errors from various Kubelets. So I took a closer look with:
```promql
{service="kubelet"} |= "failed to get network \"cbr0\" cached result"
```
There was a LOT of these errors in the logs, almost 1000 per hour! 😳
Even though there was a lot of errors there was actually only a handful of sandbox IDs causing the problem so it wasn't widespread, just frequent.
## Figuring out what was wrong
Because I'm a Professional Kubernetes Platform Engineer™ I knew exactly how to tackle this... ask the internet! So fired up DuckDuckGo, pasted in my error message and started wading through a LOT of useless results.
* I found a couple [similar](https://github.com/projectcalico/calico/issues/4084) [issues](https://github.com/projectcalico/calico/issues/7647) that people had experienced with Calico but didn't seem to fit what I was seeing.
* There was a [closed issue](https://github.com/containerd/containerd/issues/6565) against Containerd where [this comment](https://github.com/containerd/containerd/issues/6565#issuecomment-1632089810) gave me some hope in solving it with a loopback CNI but turned out unrelated also.
These did give me enough info to start looking in the right places though. There was just one problem - Talos Linux doesn't have a shell you can SSH into, it's all API driven.
`kubectl debug` to the rescue!!!
Thankfully, it's possible to mimic an SSH session using `kubectl debug` against the node. As I knew I'd need a bunch of container-related tools to help with debugging I launched a debug container using the [alpine-containertools](https://github.com/raesene/alpine-containertools) image from [Rory McCune](https://www.mccune.org.uk). Due to how the debug command mounts the host filesystem I also had to override the `CONTAINER_RUNTIME_ENDPOINT` environment variable to point to the correct location.
```bash
kubectl debug -it --image raesene/alpine-containertools \
--env CONTAINER_RUNTIME_ENDPOINT=unix:///host/run/containerd/containerd.sock \
node/talos-192-168-1-15 \
-- sh
```
Now we can start poking around on the node. First, lets see if we can force delete the sandbox pod ourself.
```bash
crictl rmp --force 055b221e44a28ce8d9120f771d5e1ef201f2457ce49c58999a0147104cca2708
Failed to stop sandbox before removing: rpc error: code = Unknown desc = failed to destroy network for sandbox "055b221e44a28ce8d9120f771d5e1ef201f2457ce49c58999a0147104cca2708": failed to get network "cbr0" cached result: decoding version from network config: unexpected end of JSON input
```
No luck! But we've been able to reproduce what Kubelet is hitting at least.
I spent a bit more time poking at `crictl` to get an understanding of the state of things. Doing so I was able to identify which pods were broken on each node.
```bash
# Get the full details about the pod in containerd
crictl inspectp --output=json 055b221e44a28ce8d9120f771d5e1ef201f2457ce49c58999a0147104cca2708
# List all pods known to containerd, and filter to those in a Notready state
crictl pods | grep NotReady
```
Eventually, after wading through all the unrelated search results one did seem relevant, a GitHub issue on `containerd`: "[Empty cache files causes "KillPodSandbox" errors when deleting pods](https://github.com/containerd/containerd/issues/8197)".
## Cleaning things up
This final GitHub issue contained one important piece of information I was missing - the location of the network cache: `/var/lib/cni/results`. This is the directory where the CNI stores a JSON file for each network it creates. So let's go take a look:
```bash
> ls -la /host/var/lib/cni/results
total 148
drwx------ 2 root root 4096 Sep 27 05:48 .
drwx------ 5 root root 52 Jun 23 2022 ..
-rw------- 1 root root 1647 Sep 27 05:47 cbr0-01d576d2f808a969bb7cb8da11d1ee3117ec4e9792d4aea33abec55318b74e01-eth0
-rw------- 1 root root 0 Jun 15 21:28 cbr0-055b221e44a28ce8d9120f771d5e1ef201f2457ce49c58999a0147104cca2708-eth0
-rw------- 1 root root 1608 Sep 27 05:48 cbr0-225486a2df0c2c8be5038245d099b4c48dc03ede648735a2b4676154650e7741-eth0
-rw------- 1 root root 2045 Sep 27 05:46 cbr0-2e848e89543e7b6491d0b47eb2be7ec620865024d942012303ede16842aa1108-eth0
-rw------- 1 root root 1638 Sep 27 05:48 cbr0-415cd18f24ec2740486a7bf254054f871bd8abe4c26bc6e27dbf1f5a10c29f69-eth0
-rw------- 1 root root 1638 Sep 27 05:46 cbr0-47d021d26d2d1935025cee58941ff68ad28e09f1337b867e0865be56dde64a2a-eth0
-rw------- 1 root root 1616 Sep 27 05:46 cbr0-5d40d2f86c6f4be7a85969f24e844ea049b41af14b97cfa3f5a655f52d4fc695-eth0
-rw------- 1 root root 1616 Sep 27 05:48 cbr0-68f252ab057496036e8852a4f6103c1b6c564f6976d04676010858a5588a9a10-eth0
-rw------- 1 root root 1596 Sep 27 05:48 cbr0-91d8805fe4b95c92f4c53e1321813b5fe9f71467c5692328bb7646649db57b22-eth0
-rw------- 1 root root 1764 Sep 27 05:48 cbr0-a0eaa73bd701c9b1b1167efd49487b48074936211de1c6be37beec5184e42691-eth0
```
Notice anything suspicious? The file size of the file associated with our failing sandbox ID is `0`. 🤔 That explains why the CNI is unable to load from the cache then - it's empty. Taking a quick look at one of the other files shows a valid JSON object with various network configuration stored within.
So lets delete this file - `rm -rf /host/var/lib/cni/results/cbr0-055b221e44a28ce8d9120f771d5e1ef201f2457ce49c58999a0147104cca2708-eth0`
With that gone, let's try again to delete the pod:
```bash
crictl rmp 055b221e44a28ce8d9120f771d5e1ef201f2457ce49c58999a0147104cca2708
Removed sandbox 055b221e44a28ce8d9120f771d5e1ef201f2457ce49c58999a0147104cca2708
```
SUCCESS! 🎉
Now we know what to clean up it's time to repeat the process for each filing sandbox ID on each node. Once that is done the kubelet logs are looking _muuuucccchhhhhhh_ better!
## Preventing this happening again
As I'm still unclear why or how these pods first failed I can't be sure it wont happen again. My current leading theories are it was either caused by a previous power failure that left the nodes in a bad state or was related to my NAS crashing as the few pods I took a close look at all had SMB volumes associated with them.
Regardless of what caused it I want to make sure I'm being more proactive going forward and leaving my cluster in a better state than it was before. I could set up a dashboard that includes the log query from Loki that we used at the start of this post but that requires me to check it often and... I'm lazy. What we really want is some alerts to annoy me when / if this happens again.
I already have quite a decent monitoring and alerting setup in my homelab made up of [VictoriaMetrics](https://victoriametrics.com), [AlertManager](https://prometheus.io/docs/alerting/latest/alertmanager/) and various metric exporters so I'm in a good starting point.
But what I am lacking is containerd metrics.
A quick search lead me to this [great post](https://collabnix.com/monitoring-containerd/) by Abraham Dahunsi covering a lot of details about monitoring containerd. This gave the information on what metrics to work with and what I can do with them but I was still missing the actual metrics. In Talos Linux the containerd metrics aren't enabled by default but thankfully it's [quite simple to enable](https://www.talos.dev/v1.11/talos-guides/configuration/containerd/), I just needed to add the following to my machine config for each of my nodes:
```yaml
machine:
files:
- content: |
[metrics]
address = "0.0.0.0:11234"
path: /etc/cri/conf.d/20-customization.part
op: create
```
I then just need to instruct [vmagent](https://docs.victoriametrics.com/victoriametrics/vmagent/) to scrape this new endpoint:
```yaml
scrape_configs:
- job_name: containerd
scrape_interval: 30s
scheme: https
tls_config:
ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
kubernetes_sd_configs:
- role: node
relabel_configs:
- action: labelmap
regex: __meta_kubernetes_node_label_(.+)
- target_label: __address__
replacement: kubernetes.default.svc:443
- source_labels: [__meta_kubernetes_node_name]
regex: (.+)
target_label: __metrics_path__
replacement: /api/v1/nodes/${1}:11234/proxy/v1/metrics
- source_labels: [__meta_kubernetes_node_name]
action: replace
target_label: kubernetes_node
```
Now I have the metrics coming in, we can put them to use at identifying issues.
**Identify failures starting a pod sandbox:**
```promql
sum by(grpc_code, instance) (
rate(grpc_server_handled_total{job="containerd", grpc_code!="OK", grpc_method="RunPodSandbox"})
) > 0
```
**Identify failures stopping or removing a pod sandbox:** (This is the issue we handled in this post)
```promql
sum by(grpc_code, grpc_method, instance) (
rate(grpc_server_handled_total{job="containerd", grpc_code!="OK", grpc_method=~"StopPodSandbox|RemovePodSandbox"})
) > 0
```
**Find all pods known to containerd that aren't known to Kubernetes:**
```promql
(
container_pids_current{namespace="k8s.io"}
unless on (container_id)
label_replace(
kube_pod_container_info,
"container_id", "$1", "container_id", "containerd://(.+)"
)
unless on (container_id)
label_replace(
kube_pod_init_container_info,
"container_id", "$1", "container_id", "containerd://(.+)"
)
)
unless on (container_id)
(
container_memory_swap_limit_bytes > 0
)
```
This last one has a lot going on but it breaks down to:
1. List all `pids` counts for all containers in the `k8s.io` namespace in containerd
2. Unless the `container_id` is also found on the `kube_pod_container_info` metric (where we need to strip the `containerd://` prefix)
3. Or the `container_id` is also found on the `kube_pod_init_container_info` metric
4. And finally only if the `container_memory_swap_limit_bytes` is greater than 0 which will filter out the sandbox containers (pause container) which aren't exposed to Kubernetes anyway.
These three then become new alerts that can notify me if any match.
```yaml
- name: containerd
rules:
- alert: ContainerdPodStartFailed
annotations:
description: |
Containerd on **{​{ .Labels.instance }}** has failed to start a pod sandbox due to **{​{ .Labels.grpc_code }}**.
expr: |
sum by(grpc_code, instance) (rate(grpc_server_handled_total{job="containerd",grpc_code!="OK", grpc_method="RunPodSandbox"})) > 0
for: 5m
labels:
severity: notify
- alert: ContainerdPodRemoveFailed
annotations:
description: |
Containerd on **{​{ .Labels.instance }}** has failed to {​{ .Labels.grpc_method }} due to **{​{ .Labels.grpc_code }}**.
expr: |
sum by(grpc_code, grpc_method, instance) (rate(grpc_server_handled_total{job="containerd", grpc_code!="OK", grpc_method=~"StopPodSandbox|RemovePodSandbox"})) > 0
for: 5m
labels:
severity: notify
- alert: ContainerdHasLeftoverContainersRunning
annotations:
description: |
Containerd on **{​{ .Labels.instance }}** has extra containers that aren't known to Kubernetes.
expr: |
(
container_pids_current{namespace="k8s.io"}
unless on (container_id)
label_replace(
kube_pod_container_info,
"container_id", "$1", "container_id", "containerd://(.+)"
)
unless on (container_id)
label_replace(
kube_pod_init_container_info,
"container_id", "$1", "container_id", "containerd://(.+)"
)
)
unless on (container_id)
(
container_memory_swap_limit_bytes > 0
)
for: 15m
labels:
severity: notify
```
## This I learnt
I'd never really used `crictl` much before this so it was good to be able to better understand it. One thing I didn't realise was it also has the concept of "pods" and "containers" which are different, but map to, those found in Kubernetes. A "pod" seems to refer to the sandbox container - that is, the container that is created to setup all the networking etc. that is needed for the workloads (this is the "pause container"). Pods can be listed with `crictl pods` and inspected with `crictl inspectp [ID]`. Containers can be listed with `crictl ps` and inspected with `crictl inspect`.
Before this I didn't really know what a CNI _actually did_ in terms of things it created etc., and I still mostly don't, but I've at least seem some hints of it in the way of the network cache files that it creates.
Debugging Talos when it goes wrong at the host level is _tricky_ as you have limited access to the node itself. This is often good as it prevents you from being able to make live changes that could be forgotten or reverted accidentally but when you actually need to fix something like this it just gets in the way. I'm very thankful for `kubectl debug` (and Rory's wonderful `alpine-containertools` image 💙) that makes this debugging possible and relatively painless.
@@ -0,0 +1,173 @@
---
layout: post.html
date: 2026-03-17
title: KubeCon EU Amsterdam 2026 - My Guide to Managing the Chaos
tags: Kubernetes KubeCon Conference
summary: |
With KubeCon just 1 week away I thought it would be good to share some of my tips and suggestions on how to make the most of the week without burning out. I've been to _a few_ KubeCon's now, both EU and US, and I’ve learned a lot about how to make the most of the week and what not to do in order to protect your health!
---
<details>
<summary>Changelog</summary>
2026-03-20:
* Added note about Maintainer Summit sold out
* Added Kubernetes Contribution 101
* Added link to Vlad Mocanu post
</details>
With KubeCon just 1 week away I thought it would be good to share some of my tips and suggestions on how to make the most of the week without burning out. I've been to _a few_ KubeCon's now, both EU and US, and I’ve learned a lot about how to make the most of the week and what not to do in order to protect your health!
> Note: While the official name is KubeCon+CloudNativeCon, that's quite a mouthful so I'll just be referring to it as KubeCon (Sorry, CNCF)
Let's start with a quick breakdown of what my week is going to look like, including the pre-events and some social activities around the conference, to give an idea of how overwhelming it can be. (Note: I'm doing a lot, don't be like me 😅)
## My Schedule Breakdown
* **Saturday:**
* [Cloud Native Rejekts](https://cloud-native.rejekts.io) - The b-side conference showcasing technical talks and community connections. A chance to hear those talks that didn’t quite make the cut at KubeCon, fostering a more relaxed atmosphere for sharing insights and building connections. This is my favourite conference and one that has a strong focus on community and technical insight. If you're in Amsterdam early enough I highly recommend attending!
* **Sunday:**
* [Maintainer Summit](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/features-add-ons/maintainer-summit/) - Great for diving deep into the core of Kubernetes and CNCF technologies. This is a free event but there are some [requirements](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/features-add-ons/maintainer-summit/#eligibility) you need to meet in order to be able to attend.
* 🎉 [KubeTrain](https://kubetrain.io) Party - The folks that organised the amazing KubeTrain initiative to encourage folks to travel to KubeCon together, more sustainably, are hosting a party to kick off the week.
* **Monday:**
* [KubeCon Co-Located Events](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/co-located-events/cncf-hosted-co-located-schedule/) - These are the official co-located events from KubeCon that require an "All-Access Pass" ticket. I’m planning on hitting up Platform Engineering Day, but there are some fantastic other options to explore depending on your technology interests.
* **Tuesday:**
* KubeCon Kicks Off! - The [schedule](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/program/schedule/) is packed with lots of talks.
* 🎉 [Booth Crawl & after-party](https://kccnceu2026.sched.com/event/2CXvd/?iframe=yes&w=100%&sidebar=yes&bg=no) - held in the sponsor hall to encourage you to speak to the various vendors and projects at KubeCon this is a great place to scope out some swag, have some drinks and chat with friends, new and old.
* 🎉 [Kuberoke](https://kuberoke.love/events/spring-party-amsterdam-2026/) - The best after-after-party! This is a fantastic evening of singing and networking with drinks and nibbles. If Karaoke is not your thing, not to worry, there is a chill out room too where you can just hang out and chat with folks.
* **Wednesday:**
* **My Talk! - "[Kube-Oddities - The Quirks That Keep Kubernetes Interesting](https://kccnceu2026.sched.com/event/2CW2p/kube-oddities-the-quirks-that-keep-kubernetes-interesting-marcus-noble-monzo-mark-sagi-kazar-independent?iframe=no)"** - Join me and Mark at 11:45 to explore the delightfully weird and wonderful aspects of Kubernetes.
* **Thursday:**
* Final Day of KubeCon - After a long, long week my main focus for the final day is to try and chat with various people I haven't managed to find yet before heading home to sleeeepppppp! 💤
## Conferences, Conferences, Conferences
KubeCon has evolved over the years and has become much more than _just a conference_. It is a place, and a time in the calendar, that the cloud native community can get together and collaborate, network and share ideas. It has evolved so much that it's no longer just one conference, there's a whole collection of official and unofficial complimentary conferences that happen around KubeCon which you should check out!
### The Official Ones
* **[KubeCon+CloudNativeCon](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/)** - This is the main conference. The number of days varies a little depending on the location (e.g. Asia/India is less days) but it is usually 3 days with keynotes each morning and sessions / workshops throughout the rest of the days.
* **[Co-Located Events](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/co-located-events/cncf-hosted-co-located-events-overview/)** - This is a collection of several topic-specific conferences hosted by CNCF the day before KubeCon begins. Access to these requires attendees to have an "All-Access Pass" ticket type which then means you're free to come and go between any of the co-located events. For KubeCon Amsterdam 2026 there are [16 co-located conferences](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/co-located-events/cncf-hosted-co-located-events-overview/)
* **[Maintainer Summit](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/features-add-ons/maintainer-summit/)** - Previously known as Contributor Summit, this is a smaller conference that brings together the builders of Kubernetes and other CNCF projects to discuss the challenges and future of the various projects. This is a great conference to get into some of the nitty-gritty details of cloud native tech but there are some [eligibility requirements](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/features-add-ons/maintainer-summit/#eligibility) you must meet to attend. (Note: This is sold out and currently waitlist only)
### The Unofficial Ones
* **[Cloud Native Rejekts](https://cloud-native.rejekts.io)** - This is the "B-side conference" to KubeCon that gives a second chance to many of those talk submissions that didn't manage to make it onto the main KubeCon schedule. It takes place, this year, on the Saturday before KubeCon starts and is [free to attend](https://pretix.eu/rejekts/rejektseu26/). There is a strong emphasis on community and technical topics here - the discussions had with attendees are some of the best. This conference holds a special place in my heart and is one of my all time favourite conferences I've attended and spoke at. So much so that when I was asked to join the Steering Committee to ensure the conference continued this year after some _drama_ I jumped at the chance to do anything and everything I could. If you are able to make it to attend, I would highly recommend it!
* **[KubeAuto Day](https://kubeauto.day)** - This is a new addition this year and takes place on the same day as the official co-located events. I haven't much to say about this yet but will be keen to see how it goes and if it becomes a regular event. 👀
## My Top Tips for a Successful (and Sustainable) KubeCon
* **Prioritise**
Don’t try to do _everything_, seriously. Have a goal that you want to achieve during the week - maybe learn about a new technology, speak to vendors about a specific problem you're looking to have solved, or technical discussions with other attendees.
For me, my goal is mainly getting updates on various projects and seeing what is likely coming in the near future. To achieve this I have two main approaches I'll be following - speaking with relevant vendors in the sponsor hall and attempting to catch various people I know in the hallway track to get updates and share ideas.
* **You don't need to attend the talks**
This might sound like a weird thing for a conference but with all the talks being recorded and [available online](https://www.youtube.com/channel/UCvqbFHwN-nwalWPjPUKpvTA) within a couple weeks of the event you're not going to miss out on any content. Instead, focus on connections - either with attendees or speakers. My general approach is to attend the talks that I think I'd want to have a follow up discussion with the speaker about. Beyond that, the talks I mainly go to are to support my friends that are speaking. 💙
* **Schedule Breaks**
Seriously, it’s essential. Step away from the venue, grab a drink, get some fresh air, some sunlight, and recharge. The noise and stuffy air can be overwhelming.
* **Keep Hydrated**
Carry a water bottle with you and refill it often. Lots of talking plus a warm venue can take it's toll on you quickly if you're not careful!
* **Network Strategically**
Speak to new people, have friends introduce you to folks, chat with vendors. There's so much that you can get from networking at KubeCon! I also recommend keeping notes - I often keep a log of who I spoke with and about what in case I want to pick up that conversation again at a later time.
* **Don’t Forget the Social Scene!**
KubeCon isn’t just about the conference (or the other conferences around it 🤣) - there are _tons_ of parties and social events happening throughout the week. Check out the full list and find the perfect one for you at [conf.party](https://conf.party).
* **Don't Be Afraid to Say No**
It's totally fine if you don't want to do everything. If parties aren't your thing, that's cool - don't attend. Look after yourself and your energy most of all.
* **If you're job hunting...**
The industry is a bit... turbulent lately, so I expect there will be a fair number of attendees on the hunt for their next role while at KubeCon. This is where networking strategically comes in handy - hit up the sponsor booths and learn about what companies are in the space and who are hiring. Speak with other attendees and see if they can recommend anything or have any tips. There is also a jobs board, usually located near the project pavilion, where people can write either that they are looking for or hiring for a job. Good luck! 🤞
> My co-speaker Mark has done a fantastic post about [How to KubeCon](https://sagikazarmark.com/blog/posts/how-to-kubecon/) and goes into more detail about a lot of these same points. Highly recommended read!
> In response to this post, [Vlad Mocanu](https://www.linkedin.com/in/vtmocanu/) has written up their own [KubeCon Survival Guide](https://hai.wxs.ro/guides/kubecon-guide/) with lots of amazing extra tips. Well worth a read!
## KubeCon Points of Interest
KubeCon itself is also more than just the talks...
* **Sponsor Showcase**
Here you will find all the sponsor booth with various companies trying to sell your their product, offer you their services and entice you in with ✨ SWAG ✨. Feel free to grab as much swag as you want (and that you can fit in your suitcase, don't forget that) but just be aware that in return you'll either need to put up with listening through a pitch from the vendor or having your badge scanned so they can email you later. Take a look at the [map](https://events.linuxfoundation.org/wp-content/uploads/2026/03/KCEU26-ExpoMap.pdf) for information of what sponsors are where.
* **Project Pavilion**
This is an area within the sponsor showcase that hosts small booths reserved for CNCF projects or groups. These are non-corporate, so not trying to sell you anything, and just a great place to hang out and meet people. The booths change each half-day so be sure to check back several times through the week. If you want some of my [custom stickers](https://bsky.app/profile/averagemarcus.bsky.social/post/3mgxc34sels22) be sure to stop by SIG-Security and chat with those wonderful folks! 💙
There are also [daily tours](https://kccnceu2026.sched.com/overview/type/Project+Opportunities/Project+Pavilion+Tours?iframe=no) of the project booths if you want to learn a bit more about them in a more structured way (and maybe make some new friends at the same time).
* **Food & Drink**
Normally, I'd warn folks about the quality of the food available at KubeCon and suggest that fussy eaters (like myself) sort out their own lunches. But I think this year the CNCF looks to be going above and beyond with the [menus available](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/attend/event-resources/#menus)! 😮 Looks like no "Grab & Go" bags this year but rather some more variety of options, including what looks like some hot food options! I'm looking forward to trying out some of these! 🤤
* **Games & Activities**
The sponsor hall will have a variety of recreation activities scattered throughout to help attendees unwind and have fun together. These include things like ping pong, table futbol and curling. There are also several [Activation Zones](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/features-add-ons/experiences/#activation-zones) set out that are sponsored activities such as mini golf and video games.
* **Professional Headshots**
Each KubeCon, there is the chance to have some free, [professional headshots](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/features-add-ons/experiences/#professional-headshots) taken to spruce up your LinkedIn profile or other online social media profile. These are on a first-come basis so be sure to get them arranged early.
* **Kubernetes Meet & Greet**
Ever wanted to put a face to the folks that volunteer for the various SIGs and working groups that keep the project going? Well come along to the [Meet & Greet](https://kccnceu2026.sched.com/event/2H66n) after grabbing some lunch and have a nice chat with some lovely folks.
* **Documentary Screening**
If you're interested in learning more about the history of [Backstage](https://backstage.io) there will be a screening of the new [Backstage: From Spreadsheet to Standard](https://kccnceu2026.sched.com/event/2ILJt/documentary-premiere-backstage-from-spreadsheet-to-standard) documentary to wrap up the Wednesday.
* **Fun Run**
Like a nice early morning run with friends? Join fellow attendees Wednesday morning for a [Fun Run](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/features-add-ons/experiences/#wellness) (or walk), starting at the conference venue. No pressure, go at your own pace, enjoy a bit of early-morning Amsterdam with friends.
* **ContribFest**
Throughout the week there are several CNCF projects hosting [ContribFest session](https://kccnceu2026.sched.com/overview/type/%F0%9F%9A%A8+Contribfest?iframe=no) where anyone is invited to show up and help contributing to the project in a structured way. This is a great way to get some experience with a new technology or to contribute back to a project you rely on.
* **Kubernetes Contribution 101**
If you're looking to start contributing to open source but not sure where to start then there is a [session Tuesday afternoon](https://kccnceu2026.sched.com/event/2ITlD/kubernetes-contribution-101) dedicated to getting folks ready for their first contribution.
Take a look at the [venue map](https://events.linuxfoundation.org/wp-content/uploads/2026/03/KCEU26-VenueMap.pdf) to find out where the various keynotes, sessions and activities can be found.
## Beyond the Conference
As I mentioned above, the social scene around KubeCon is _vibrant_ and seems to get bigger every year. There's lots to pick from on [conf.party](https://conf.party) but be aware that for most you will need to register and for some of those you will need to be accepted before you can attend.
If you're looking for some recommendations on what to attend, here's my personal highlights:
* **[Kuberoke](https://kuberoke.love/events/spring-party-amsterdam-2026/)** - This community run party is a must! It is scheduled on the evening of the first day of the main conference and acts as the after-after-party following the booth crawl. While karaoke might not be your thing there is still plenty of opportunity to unwind and mingle with your fellow attendees without the need to sing. This is a free event with some food and drink provided, just be sure to [get a ticket](https://ti.to/kuberoke/kuberoke-spring-party-amsterdam-2026) while you still can!
* **[KubeTrain Party](https://tickets.kubetrain.io)** - If you're in Amsterdam on the Sunday then this should be on your list! KubeTrain is a fantastic community initiative to encourage folks to travel to KubeCon together using more sustainable travel methods and then get together before the week of conferences to kick things off with a fantastic party.
* **[Nordic Night Out](https://community.cncf.io/events/details/cncf-cloud-native-goteborg-presents-nordic-night-out-at-kubecon-cloudnativecon-eu/)** - This one is quite niche but I really like this kind of thing. The Nordic community are hosting a little get together at KubeCon where they can all meet up and network. Having spoken at a few Nordic conferences now I can vouch for how wonderful their community is - so lovely and friendly!
* **[#KubeCrawl + #CloudNativeFest](https://conf.party/kubecon-eu-2026.html)** - This is the official KubeCon after-party that takes place in the sponsor hall. Expect drinks, food and good conversations. Also a great opportunity to pick up some swag or scope out the sponsors without too much pressure to stay and talk if you don't want to.
* **[Isovalent Hive Mind Mingle](https://isovalent.com/events/2026-kubecon-hive-mind-mingle-amsterdam/)** - The Isovalent team always put on a great night and this event is always one of the best. Great people, great conversations, great atmosphere!
## Amsterdam Resources
* The wonderful folks at [SIG-Foodies](https://sig-foodies.github.io) have put together an [amazing guide to food and drink in Amsterdam](https://sig-foodies.github.io/amsterdam.html) that should cater to just about everyone's tastes! Just reading this guide makes my tummy rumble! 🤤
* Getting around Amsterdam is generally quite easy and you have lots of options:
* Walking - A lot of Amsterdam is easily walkable and, weather permitting, a very pleasant experience. Just watch out for the canals 😉.
* Biking - Amsterdam is big on bicycles! You will see lots of locals getting around the city on a bike and there are plenty of places where you can hire one yourself to get around easily.
* Public Transport - Amsterdam has a great metro, tram and bus system that makes it super easy and quick to get just about anywhere. My plan is to get a [multi-day GVB ticket](https://www.gvb.nl/en/travel-products/gvb-multi-day-ticket) that can be used the entire week.
## Wrap-Up
Hopefully this guide helps you make the most of KubeCon Amsterdam 2026!
Don’t miss out on the incredible announcements and insights that will be unveiled throughout KubeCon! And if you aren't able to make it, don’t worry - I'll be including all the news and gossip in my newsletter at the end of the month! Sign up to [CloudNative.Now](https://cloudnative.now) to make sure you don't miss out!
+1 -1
View File
@@ -1,4 +1,4 @@
<figure class="center {{ class }}" markdown="1">
<figure class="center {{ class }}">
<a href="{{ url}}" target="_blank">
<img src="{{url}}" alt="{{ alt }}">
</a>
+2 -2
View File
@@ -1,6 +1,6 @@
<figure class="center" markdown="1">
<figure class="center">
[![](https://tweet.cluster.fun/{{id}})](https://twitter.com/user/status/{{id}})
<a href="https://tweet.cluster.fun/{{id}}">[![](https://tweet.cluster.fun/{{id}})](https://twitter.com/user/status/{{id}})</a>
<figcaption>{{caption}}</figcaption>
</figure>
+2
View File
@@ -35,8 +35,10 @@
<link rel="stylesheet" href="/css/zenburn.css" async defer>
<script type="text/javascript" src="/js/highlight.min.js"></script>
<script type="text/javascript" src="/js/terraform.js"></script>
<script type="text/javascript" src="/js/promql.js"></script>
<script>
hljs.registerLanguage('terraform', window.hljsDefineTerraform);
hljs.registerLanguage('promql', window.hljsDefinePromQL);
hljs.highlightAll();
</script>