スキル routeros-app-yaml

📦

routeros-app-yaml

Name: routeros-app-yaml
Author: tikoci

安全 ⚙️ 外部コマンド🌐 ネットワークアクセス

RouterOSコンテナYAML構成の記述

MikroTik RouterOSコンテナアプリケーション用のYAML構成を作成および検証します。このスキルにより、docker-composeの知識がなくても、RouterOS /appサブシステムのサービス、ポート、ボリューム、ネットワークを定義できます。

対応: Claude Codex Code(CC)

🥉 73 ブロンズ

スキルZIPをダウンロード

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

オンにして利用開始

テストする

「routeros-app-yaml」を使用しています。ポート8123で永続ストレージを備えたHome Assistantコンテナの/app YAMLを作成してください

期待される結果:

name、services、volumes、networksセクションを含むYAMLファイル。
Webサービスはghcr.io/home-assistant/home-assistantイメージを使用し、ポート8123をマッピング。
名前付きボリュームhome-assistant-configが/configにマウントされている。
再開策は信頼性のためにalwaysに設定されている。

「routeros-app-yaml」を使用しています。 RouterOS YAMLの古い形式と新しいポート形式の違いを表示してください

期待される結果:

古いOCIスタイルはプロトコルの前にスラッシュを使用：8080:80/tcp
新しいRouterOS 7.23スタイルはコロンを使用：8080:80:web:tcp
両方の形式が有効です。7.23beta2からの新しい展開ではコロン形式を優先してください。
target、published、protocolフィールドを含む長い形式のオブジェクト構文はすべてのバージョンで動作します。

セキュリティ監査

安全

v2 • 4/16/2026

All 159 static analysis findings are false positives. The skill contains only documentation and YAML configuration examples for RouterOS container applications. There is no executable code, no actual shell commands, no network requests, and no credential handling. The static scanner flagged YAML examples in markdown code blocks as security risks (for example, backticks in YAML values, example URLs in documentation, and placeholder IP addresses in configuration samples). After manual review, no genuine security issues were found.

スキャンされたファイル

453

解析された行数

検出結果

総監査数

低リスクの問題 (3)

SKILL.md:1-276 references/examples.md:1-177

False positive: External command detection in YAML documentation

The static scanner flagged 132 locations as external command execution. These are YAML configuration examples and markdown documentation, not executable code. Examples include shell commands in YAML entrypoint values (for example, nginx -g daemon off in SKILL.md line 32 and references/examples.md line 31) and backtick-formatted text in markdown. No actual command execution exists.

SKILL.md:110-275 references/examples.md:19-173

False positive: Network pattern detection in documentation URLs

The static scanner flagged 13 locations as network risks including hardcoded URLs, hardcoded IP addresses, and fetch API calls. All are documentation examples: example.com URLs in YAML samples (references/examples.md lines 19, 21), example IP addresses like 192.168.1.1 in port mapping examples (SKILL.md line 110, references/examples.md line 145), and TypeScript fetch snippets showing RouterOS REST API usage (SKILL.md lines 216, 222). No actual network requests are made by this skill.

SKILL.md:1-276 references/examples.md:1-177

False positive: Blocker patterns misidentified in YAML content

The static scanner flagged weak cryptographic algorithms, Windows SAM database references, LLM role token injection, and system reconnaissance patterns. None of these patterns exist in the actual file content. The scanner likely misidentified YAML property names or markdown formatting as security threats.

リスク要因

⚙️ 外部コマンド (132)

🌐 ネットワークアクセス (13)

references/examples.md:19 references/examples.md:21 references/examples.md:57 references/examples.md:101 references/examples.md:173 references/examples.md:145 SKILL.md:216 SKILL.md:222 SKILL.md:225 SKILL.md:248 SKILL.md:249 SKILL.md:275 SKILL.md:110

監査者: claude 監査履歴を表示 →

品質スコア

アーキテクチャ

100

保守性

コンテンツ

コミュニティ

セキュリティ

100

仕様準拠

作れるもの

RouterOS用のコンテナアプリケーションを定義する

ネットワーク管理者がYAMLを記述して、/appサブシステムを使用してMikroTikルータにGrafanaとPrometheusを使用した監視スタックを展開します。

docker-composeプロジェクトをRouterOSに移行する

開発者が既存のdocker-compose設定をRouterOS /app YAML形式に適応させ、ポート構文の調整とサポートされていないプロパティの削除を行います。

チーム展開用のアプリストアを作成する

システムエンジニアが、複数のRouterOSデバイス間での一貫した展開用に事前設定されたアプリケーションを含むtikappstore YAMLファイルを作成します。

これらのプロンプトを試す

基本的な/app定義を作成する

ポート8080で永続データ用の名前付きボリュームを備えたnginxコンテナを実行するRouterOS /app YAMLファイルを記述してください。

docker-composeをRouterOS YAMLに変換する

このdocker-composeファイルをRouterOS /app YAML形式に変換してください。サポートされていないプロパティや動作が異なるプロパティをハイライトしてください。

マルチサービスアプリケーションを作成する

Webフロントエンド、PostgreSQLデータベース、Redisキャッシュを含むRouterOS /app YAMLを記述してください。適切なボリュームマウント、ネットワーク分離、ヘルスチェックを含めてください。

アプリストアファイルをビルドする

Webサーバー、データベースマネージャー、監視ダッシュボードの3つのアプリケーションを含むRouterOSアプリストアYAMLファイルを作成してください。 각각適切なカテゴリとメタデータを持つ必要があります。

ベストプラクティス

カスタムRouterOSアプリ定義には.tikapp.yamlファイル拡張子を常に使用し、一般的なYAMLファイルと区別してください。
開発中は*.editor.jsonスキーマバリアントを使用してより良いオートコンプリートを取得し、展開前に*.latest.jsonに対して検証してください。
本番ハードウェアに展開する前に、RouterOS CHR仮想マシンでYAMLをテストして、早期にスキーマエラーを検出してください。

回避

完全なdocker-compose互換性を想定すること。RouterOS /appはcomposeプロパティのサブセットのみをサポートし、いくつかは異なる方法で処理されます。
バージョン最上位キーの使用。RouterOSはこのキーを無視し、/app YAMLでは目的を果たしません。
単一のポート文字列内でのポート形式スタイルの混合。各ポートエントリは古いOCIスタイルまたは新しいコロンスタイルのいずれかを排他的に使用する必要があります。

よくある質問

/app YAMLにはどのRouterOSバージョンが必要ですか？

/appパスはRouterOS 7.21から組み込まれています。/app/addによるカスタムアプリ作成にはRouterOS 7.22以降が必要です。コンテナ拡張パッケージもインストールする必要があります。

RouterOS /app YAMLはdocker-composeと同じですか？

いいえ。RouterOS /app YAMLはdocker-composeに似ていますが、プロパティのサポート数は少なくなっています。deployやresourcesなどのプロパティはサポートされていません。ポートマッピング構文も两者で異なります。

/app YAMLファイルにはどのファイル拡張子を使用すべきですか？

個々のアプリ定義には.tikapp.yamlを使用し、アプリストアファイルには.tikappstore.yamlを使用してください。これらの規則によりツールとエディタが正しいスキーマを適用しやすくなります。

RouterOS YAMLでプレースホルダーはどのように機能しますか？

[accessIP]、[accessPort]、[containerIP]、[routerIP]などのプレースホルダーは、展開時にRouterOSによって展開されます。これらはポートマッピング、環境値、設定コンテンツに表示されます。

小文字の環境変数を使用できますか？

厳密な検証スキーマでは、パターン[A-Z_][A-Z0-9_]*に一致する大文字の環境変数名を必要があります。大文字と小文字が混在する変数名が必要な場合は、エディタスキーマバリアントを使用してください。

カスタムアプリをRouterOSに追加するにはどうすればよいですか？

CLIコマンド/app/addとyaml-urlパラメータを使用してYAMLファイルのURLを指すか、代替としてリクエストボディにyaml-urlを含むREST API PUTエンドポイント/appを使用してください。

開発者の詳細

作成者

tikoci

ライセンス

MIT

リポジトリ

https://github.com/tikoci/routeros-skills/tree/main/routeros-app-yaml

参照

main

ファイル構成

📁 references/

📄 examples.md

📄 SKILL.md