タグ検索の該当結果が少ないため、タイトル検索結果を表示しています。
久しぶりのtblsの新機能紹介エントリです。 ドキュメントのER図出力にMermaidを指定できるようになりました ER図の出力フォーマットにMermaidを指定できるようになりました。次のように er.format: セクションか --er-format オプションに mermaid を指定することで変更できます。 er: format: mermaid 開発裏話 GitHubがMermaid対応したことで「tblsもMermaid対応してほしい」という要望や提案は以前より多く受け取っていました。 しかし、個人的にあまりメリットを見出せずそのままPull Request待ちとなっていたのですが、今回エイッと作ってみました。 Mermaid対応をするにあたって1つとても面倒な仕様がありました。それはMermaidはER図の多重度（カーディナリティ）の指定が必須となっていることでした。 もと
BASEアドベントカレンダー2021 10日目の記事です。 BASEアドベントカレンダー2021 10日目 BASE BANKでエンジニアをしている @budougumi0617 です。 マイグレーションファイルが含まれたPull Request（PR）が作られたとき、自動更新したER図をPRに追加するGitHub Actionsを作りました。 本記事では紹介するGitHub Actionsを利用すると次のようなメリットが得られます。 マイグレーションファイルをPRに出すだけでPRに更新されたER図が追加される 開発者は面倒なER図の更新作業から開放される レビューアはマイグレーションファイルを含んだPRをER図を見ながらレビューできるようになる プロジェクト関係者は常にメインブランチのマイグレーションファイルの状態と一致したER図を確認できる サンプルPR 自動生成したER図 TL;DR
この度、私が開発している以下の5つのOSSにおいて、ライセンスに関する重大な誤りがあったことをご報告し、深くお詫び申し上げます。 https://github.com/k1LoW/tbls ( v1.51.0 - v1.88.0 ) https://github.com/k1LoW/runn ( v0.71.0 - v0.138.0 ) https://github.com/k1LoW/sshc ( v4.0.0 - v4.2.1 ) https://github.com/k1LoW/httpstub ( v0.9.0 - v0.23.0 ) https://github.com/k1LoW/grpcstub ( v0.8.0 - v0.25.12 ) それぞれ MITライセンス で配布しておりますが、誤って AGPL-3.0ライセンスの第三者ライブラリを含んだままリリースしていました。
https://fortee.jp/phpconfukuoka-2023/proposal/df1faefa-056a-493a-87d3-45934e96ea8c
「tblsで出したER図をGitHub Pagesに出したいな〜〜！の砂場」というレポジトリを作って遊んでました。 「(学習・実装面で)低コスト」「(実用性の面で)ほどほどに十分」という方法を探っていたのですが、概ね満たしたと思います。満足。 github.com 場面設定 ER図をいい感じに！！っていうのはk1LoWさんが解決してくれているので、その先の話。 qiita.com (↓の資料、改めて読んだけどやっぱり良いので凄い。もっと使い込みたいな・・) The future of tbls and "Documentation as Code" / phpconfuk 2023 - Speaker Deck 「MarkdownだからGitHub上ですごく簡単に見られる」というのが嬉しく、継続的にドキュメントを管理(更新＆利用)していくのを強力に支援してくれるな〜と思いつつ、 「自動生成
この記事はSafie Engineers' Blog! Advent Calendar 2日目の記事です。 セーフィー株式会社でテックリードをやっております鈴木敦志です。 セーフィーはクラウドカメラのSaaSを提供しており、現在22万台程度のデバイスに対してカメラ映像をクラウドから視聴する機能を提供しています。 それに加えエンタープライズ向けの権限管理機能や社内向けの販売管理ツールなど複数のサービスを運営しており、各サービスでMySQLのDBを共有しているためDBのテーブル数が肥大化し構造がわかりにくくなり、新機能開発の妨げとなっていました。 本稿ではデータベースのドキュメンテーションツールである tbls を導入し、DBスキーマ管理ツール skeema、ドキュメント生成ツール mkdocs、Github Actionsなどと組み合わせてスキーマ管理からドキュメント生成までをやっていきます
タイトルが何を言っているのかよくわからないと思いますので順を追って紹介したいと思います。 tblsをセットアップするGitHub Actionとしてsetup-tbls を作った setup-tblsはtblsをインストールしてくれるGitHub Actionです。 github.com 各所で「ないの？」とは言われており（最近Issueもたった）、いつか作らないとなと思っていたのですが、いろいろ重なって作りました。 github.com 私はGoで作ったツールのActionはDocker container actionを使うのですが、tblsでそうするとDockerコンテナ上で動くtblsからデータベースサーバの名前解決ができなかったりして、それも手を鈍らせている原因でした。 今回作成した setup-tbls はComposite actionで作っているので上記のような心配もありま
tbls はいいぞ 🦍 筆者は tbls の大ファンであり、特に Viewpoints 機能が他のツールとは一線を画していると思っています。今回はその良さをお伝えできればと思います。 TL;DR tbls は実際のスキーマから DB のドキュメントを生成するツール ER 図が巨大化しても、tbls の Viewpoint ごとに分割することで DB の全体像が理解可能になる Viewpoint の粒度に困ったら一旦トランザクションと集計の単位に設定する 個別のテーブルと Viewpoint は相互に参照できる CI に組み込むことでドキュメンテーション忘れを防げる なんのために DB のドキュメンテーションを行うか DB のドキュメンテーションはそれなりにコストがかかるため、おざなりにされることも少なくありません。 しかし、下記のようなケースを考えるとドキュメンテーションは必須であると言
概要 最近、Liam ERDというOSSのER図自動作成ツールが公開されました。 気になっていたものの、MySQLに対応していなかったので一旦様子見していたのですが、tbls経由でのサポートが発表されたので触ってみます。 元々対応していたPostgreSQLなどに加えて、tblsがサポートするSQLiteやBigQueryなどにも対応したようです。以下の図がわかりやすいですね。 引用：Announcing Liam ERD Integration with tbls」 Liam ERDとは OSSのER図自動生成ツールで、SchemaSpyなどに似ていますが、セットアップがより簡単で可読性が高いです。 Web版とCLI版が用意されており、パブリックなGitHubリポジトリであれば、一瞬でER図をレンダリングできます。 実行手順 では実際にER図を作成していきます。 今回はサンプルとして、M
はじめに こんにちは、サーバーサイドエンジニアの @shiroemons です。 プルリクエストにDBスキーマの変更が含まれた場合、ER図を自動生成するために、tblsとGitHub Actionsを組み合わせた設定を行いました。 DBスキーマの変更は開発プロセスにおいて頻繁に発生しますが、手動でER図やドキュメントを更新することは煩雑で効率が悪い作業です。 そこで、GitHub Actionsとtblsを使用することで、ER図の自動生成と更新を容易に実現できました。 今回は、設定したGitHub Actionsの設定ファイルを紹介します。 必要なツールと環境 今回紹介するツールと環境はこちらです。 CI: GitHub Actions DB: PostgreSQL マイグレーションツール: psqldef テーブル定義書作成: tbls tbls について github.com tbls
EC事業部でシニアエンジニアリングリードをしているkenchanです。この記事はEC事業部ブログリレーの4日目の記事で、3日目はakatsuuraによるRuby のコードリーディング会に参加して1年経ちましたでした。 カラーミーショップの開発チームでは、2020年末にデータベースドキュメンテーションツールとしてtblsを導入しました。本記事では、tblsの機能や導入の狙いから、実際の移行のプロセスをふりかえり、最後に今後やっていきたいことについて紹介します。データベースドキュメントの継続的なメンテナンスに課題を感じている方の参考になれば幸いです。 tblsとは何か k1LoW/tblsは、ホスティング事業部の@k1LoWが開発、メンテナンスをしているデータベースのドキュメンテーションツールです。tblsを使うことで、MySQLやPostgreSQLなどのRDBMSはもちろん、BigQuer
背景・動機日頃から k1LoW/tbls を 利用しているが、個人的に気に入ってる運用をメモしておく。 試したこと・やったこと1. GitHub ActionsでDBに入れつつtblsを実行するtblsをセットアップするGitHub Actionとしてsetup-tbls（を作るツールとしてgh-setup）を作った にもあるとおり、k1low/setup-tbls を利用すればGitHub Actions上でtblsを簡単に利用できる。 以下はISUCONで使っているGitHub Actionsだが、Laravelでも同じように php artisan migrate すればよい。 main branchにpushされたら更新される。 MySQLのセットアップtblsをインストールDBにスキーマ情報を反映tbls docを実行するdbdoc branchに ./dbdoc を反映してpu
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
