実行できる手順書「LC4RI」で快適な運用ライフを送ろう！ PEK登壇ダイジェスト版

>100 Views

October 01, 26

スライド概要

IaCやCI/CDによるプラットフォーム運用の自動化が進む一方で、根幹となるオペレーションは依然としてコピー＆ペーストやタイピングによる手作業が主流であり、手順飛ばしや、タイプミスによる作業ミスのリスクを抱えています。さらに、扱う技術要素の多様化、複雑化により、プラットフォームエンジニアの認知負荷の増大が深刻な課題となっています。AIエージェントによる自動化も可能ではありますが、現時点では予期せぬ環境破壊のリスクがあるため、人による手作業に頼らざるを得ないのが実情です。本セッションでは、この課題を解決するため、LLMと相性の良いMarkdown形式の運用手順書をそのまま実行可能にする手法「Literate Computing for Reproducible Infrastructure（LC4RI）」を組織に導入した実践事例をご紹介します。
①スモールスタートからの組織展開
チームレベルでLC4RIをツールに落とし込み運用を開始。Markdown形式のコマンド部分のみを実行し、結果を元のドキュメントに反映させる仕組みを実装しました。LLMを活用しながらスピーディに手法の評価と追加実装を重ね、運用手順の品質を担保しつつチームレベルの検証や活用から部署レベルの組織全体へ展開しました。
②Notion AIを活用した再現性の高い手順生成
運用証跡として、誰が・いつ・どのような結果を得たか、をNotionにアーティファクトとして記録。蓄積された過去の実績をNotion AIが学習・生成することで、ケースバイケースで再現性の高い運用手順を作成可能にしました。
③今後の課題
手順のマスター管理や環境差分の吸収など今後の課題はありますが、生成と実績のループにより蓄積されたドキュメントは、将来的に人間とAIエージェントが安全に作業を行うためのインタフェースとなり、危険な作業を抑制するオントロジーとなります。その先にある人間は承認と例外対応に集中し、AIに安全に作業を委ねる「AI Native Platform Engineering」の世界観が実現します。

Yasutaka Kato

@ma_anago

スライド一覧

Credo: この腕で切った傷さえもっと愛せるならガンガンとITネタ発信してますのでどしどしフォローしてね！名前の由来はイモリを二匹飼ってるからです

またはPlayer版

埋め込む »CMSなどでJSが使えない場合

ダウンロード

関連スライド

実行できる手順書「LC4RI」で快適な運用ライフを送ろう！

Yasutaka Kato 11.8K

SREできのこるために

Yasutaka Kato 1.9K

AI時代の移行戦略　〜八つ目の”R”〜

Yasutaka Kato 536

Notion AIで手順書運用しようず

Yasutaka Kato 214

KH Coder 3 チュートリアル

HIGUCHI Koichi 735.7K

【初心者向け】UE5 シーケンサーと Movie Render Queue の使い方【Cinematic Dive 2023】

ue5 ue-nongame

エピックゲームズジャパン 317.3K

各ページのテキスト

重大告知 Platform Engineering Kaigi 2026 に登壇決定！ Room B | 12:15 - 12:45 LC4RIによる実行可能ドキュメントとナレッジ化の実践記新しいIaC自動化の形 ”LC4RI”とは？

オペレーション自動化のこれまで構成管理ツールの時代 IaC、そして“冪等性”の時代へ最初は Chef が流行りましたよね。そこから次第に、Ansible を使うことが多くなってきました。やがて Terraform が出てきて、IaCにおける “冪等性” の概念がすごく高まりました。「サーバの状態をコードで書いて管理する」という発想が、この頃から一気に広まった印象です。「何度実行しても同じ状態に収束する」という考え方ですね。いまの自動化の主役は、だいたいこっちのルートの話です。 IaCを代表する冪等性の実装 Copyright © 3-shake, Inc. All Rights Reserved. クラウドインフラ時代の代表的な実装 4

そもそも LC4RI って何？【いまのあるある】【LC4RIなら】まだコピペで運用していませんか？そのまま実行できる手順書へ手順書にあたるドキュメントを、いまだにターミナルにコピペしてオペレーションしているケース、けっどう多いと思うんです。ドキュメントとコマンドが一体化。ドキュメント上のコマンドをそのまま実行し、その実行結果まで同じ場所に記録・蓄積されます。 LC4RIは、そんな非効率な作業をまるごと解消できます。 Excel手順書の置き換えや、実行エビデンス取得の自動化に最適です。こちらが日本の情報ポータルサイトとなります https://literate-computing.github.io/fastpages/introduction_ja/ Copyright © 3-shake, Inc. All Rights Reserved. 区切りごとにコマンドを実行して結果を得ます https://github.com/NII-cloud-operation/Literate-computing-Basics 6

LC4RI がもたらす効果 spellcheck playlist_add_check description typo が無い手順飛ばしが起きないエビデンスが確実に残る手順のまま実行するので、そもそも打ち間違いが起きません。上から順に実行していくので、うっかり工程を飛ばすことがありません。実行結果がそのままドキュメントに残ります。誰でも後から確認できる変換要らずで直感的結果を補完しておけば、「誰が・どんなオペレーションをして・どんな結果になったか」を、あとから誰でも簡単に追跡・確認できるようになります。実行内容そのままで非常に分かりやすい！AnsibleのようにコマンドをYAMLへ変換する手間が一切不要なため、運用のハードルを劇的に下げられます。 Copyright © 3-shake, Inc. All Rights Reserved. 7

じゃあ、なぜ流行っていないのか？一番有名な実装は Jupyter Notebookを使う方法 Notebook に SSH やコマンドを投げ込んで実行させる形式が、この分野ではもっとも有名です。環境と準備に手間がかかるただ、Notebook を起動する環境が要るし、SSH をするので対象に手軽にアクセスさせる準備も要る。要は、環境や準備の手間が地味に重いんですよね。 Jupyter Notebook自体は良いものですが準備のハードルがあるのも事実なので、あまり実践されていない印象。正直めっちゃ勿体ないなと思ってます Copyright © 3-shake, Inc. All Rights Reserved. 9

10.

11.

12.

13.

14.

15.

16.

生成と実績のループ：溜めるほど、再現性が上がる ① 実行 ② 蓄積 ③ 生成手順を実行し、証跡を残す Notion に実績を蓄積 Notion AI が手順を生成コマンドと実行結果を誰が・いつ・どんな結果を実績を学習し、再現性のそのまま書き残すアーティファクト化高い手順を組み立てる回すほど再現性が上がる — 生成と実績が同じ場所で循環します。 Copyright © 3-shake, Inc. All Rights Reserved. 26 16

17.

18.

終制作・著作 ━━━━━ ❸ⒽⓀ

19.

ZennでFREE本書いてまとめてみたので読んでね！実行できる手順書「LC4RI」で快適なオペレーションライフを送ろう！この本を読むと身につくもの ● コピペオペレーションからの脱却！手順書をそのまま実行できる「 Zenn で無料公開中！ QRコードから今すぐアクセス LC4RI」の概念と実践方法 ● 実行結果つき手順書の書き方・運用のコツ本書の内容 ● これまでのIaCとは別軸にある、「実行できる手順書」という自動化の考え方 ● 実行できる手順書の書き方と実践のためのツールの使い方、組織展開手法 URLはこちら https://zenn.dev/yasutakatou/books/0ac6588b7c9a83 この技術について気になったらぜひお話しましょう！こういうふうに使えないか？とかツールもっとこういうのが欲しいとかご意見おまちしております〜 Copyright © 3-shake, Inc. All Rights Reserved.

https://zenn.dev/yasutakatou/books/0ac6588b7c9a83

実行できる手順書「LC4RI」で 快適な運用ライフを送ろう！ PEK登壇ダイジェスト版