Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Private Cloudを支える最高のユーザーガイド運用技術
Search
andoshin11
February 10, 2021
Technology
0
300
Private Cloudを支える最高のユーザーガイド運用技術
社内サービスにおけるメンテナブルなドキュメント運用についてお話します。
andoshin11
February 10, 2021
Tweet
Share
More Decks by andoshin11
See All by andoshin11
カーナベルにおけるProtobuf二次利用例
andoshin11
0
110
Envoy External AuthZとgRPC Extensionを利用した「頑張らない」Microservices認証認可基盤
andoshin11
0
650
カーナベル株式会社2024年2月 エンジニアイベント資料
andoshin11
0
350
TS CompilerがVueを喋れても良いじゃないか
andoshin11
0
740
ain't giving up type-safe Express
andoshin11
2
440
Type Safe "Everything"
andoshin11
0
250
Hack your Nuxt router!
andoshin11
0
1.3k
GatewayパターンとSchema駆動開発
andoshin11
7
1.4k
Catch up Nuxt.js 2019.02
andoshin11
0
2.1k
Other Decks in Technology
See All in Technology
伴走から自律へ: 形式知へと導くSREイネーブリングによる プロダクトチームの信頼性オーナーシップ向上 / SRE NEXT 2025
visional_engineering_and_design
3
460
United™️ Airlines®️ Customer®️ USA Contact Numbers: Complete 2025 Support Guide
flyunitedguide
0
800
Bill One 開発エンジニア 紹介資料
sansan33
PRO
4
13k
united airlines ™®️ USA Contact Numbers: Complete 2025 Support Guide
flyunitedhelp
1
470
Copilot coding agentにベットしたいCTOが開発組織で取り組んだこと / GitHub Copilot coding agent in Team
tnir
0
200
QuickSight SPICE の効果的な運用戦略~S3 + Athena 構成での実践ノウハウ~/quicksight-spice-s3-athena-best-practices
emiki
0
290
Rethinking Incident Response: Context-Aware AI in Practice
rrreeeyyy
2
940
[SRE NEXT] ARR150億円_エンジニア140名_27チーム_17プロダクトから始めるSLO.pdf
satos
5
3k
Four Keysから始める信頼性の改善 - SRE NEXT 2025
ozakikota
0
420
20250708オープンエンドな探索と知識発見
sakana_ai
PRO
4
1k
How to Quickly Call American Airlines®️ U.S. Customer Care : Full Guide
flyaahelpguide
0
240
Data Engineering Study#30 LT資料
tetsuroito
1
200
Featured
See All Featured
How STYLIGHT went responsive
nonsquared
100
5.6k
RailsConf 2023
tenderlove
30
1.1k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
30
2.2k
Art, The Web, and Tiny UX
lynnandtonic
299
21k
It's Worth the Effort
3n
185
28k
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
irinanazarova
8
830
Rebuilding a faster, lazier Slack
samanthasiow
83
9.1k
Build your cross-platform service in a week with App Engine
jlugia
231
18k
JavaScript: Past, Present, and Future - NDC Porto 2020
reverentgeek
50
5.5k
Fireside Chat
paigeccino
37
3.5k
How GitHub (no longer) Works
holman
314
140k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
45
7.5k
Transcript
Private Cloudを支える “最高”のユーザーガイド運用技術 Shin Ando / @andoshin11
Shin Ando • @andoshin11 • Ex-Frontend / Backend / DevOps
Engineer • BizDev at LINE Corporation • Verda Customer Relation Committee Lead
昨日ちょっとバズったやつ
None
LINE開発者が利用するPrivate Cloud基盤 2021.02現在
Verda CRC Customer Relation Committeeとは? • Verdaは社内サービスとはいえ、Potential Userは2,500+名 • Verdaの構成メンバーはインフラエンジニアがほとんど
• CRC = クラウド基盤の価値を最大化するための組織 ◦ User Guideの運用補助・コンテンツディレクション ◦ Release Notesのデリバリー設計 ◦ Service Roadmapの提供 ◦ RFC Processの設計 ◦ サポートオペレーション最適化・顧客の利用状況の分析 ◦ etc...
Verda CRC Customer Relation Committeeとは? • Verdaは社内サービスとはいえ、Potential Userは2,500+名 • Verdaの構成メンバーはインフラエンジニアがほとんど
• CRC = クラウド基盤の価値を最大化するための組織 ◦ User Guideの運用補助・コンテンツディレクション ◦ Release Notesのデリバリー設計 ◦ Service Roadmapの提供 ◦ RFC Processの設計 ◦ サポートオペレーション最適化・顧客の利用状況の分析 ◦ etc... 今日はここの話をします
最高のUser Guide運用 スケールする 開発支援技術 高品質なコンテンツ を維持するカラクリ アクセシビリティを 最大化するCDと基盤 DX Testing
Deployment
01DX - Developer Experience - スケールする開発支援技術
Developer Experience
Developer Experience SSG可能なNuxt ContentでMarkdown Fileを管理
Developer Experience
• 非Node.jsエンジニアが編集環境を立ち 上げやすいよう、Docker Imageを用意
• 非Node.jsエンジニアが編集環境を立ち 上げやすいよう、Docker Imageを用意 • タスクランナーにはMakeを利用
• 非Node.jsエンジニアが編集環境を立ち 上げやすいよう、Docker Imageを用意 • タスクランナーにはMakeを利用 • 効率的なコンテンツレビューを行うため のPR Template
• 非Node.jsエンジニアが編集環境を立ち 上げやすいよう、Docker Imageを用意 • タスクランナーにはMakeを利用 • 効率的なコンテンツレビューを行うため のPR Template
• Contributorを増やすための Development Guide
02Testing 高品質なコンテンツを維持する カラクリ
Linting
Linting typoの検知 + より良い記述の提案
Visual Regression Testing ✖
• contentsディレクトリのファイル構成から URLを生成し、対象ページのキャプチャ を撮影するクローラーを自前で用意
• contentsディレクトリのファイル構成から URLを生成し、対象ページのキャプチャ を撮影するクローラーを自前で用意 • CI上でreg-suitによるpixel by pixelの画 像回帰テストを実行
• contentsディレクトリのファイル構成から URLを生成し、対象ページのキャプチャ を撮影するクローラーを自前で用意 • CI上でreg-suitによるpixel by pixelの画 像回帰テストを実行 •
キャプチャ画像の保存にはVerda Object Storageを利用 (S3 API Compatible)
03Deployment アクセシビリティを 最大化するCDとインフラ基盤
Hosting Environment
Hosting Environment Manifest Repo 1. Webhook 2. Push Image Drone
CI harbor 3. Update Manifest 4. Webhook 5. Update Nginx Pod Argo CD User Guide Pod User Guide Repo Ingress Controller Verda User 6. Pull Image CRC Cluster
Indexing on Elasticsearch
• Markdownからコンテンツ情報とmeta情 報をパースしてElasticsearchにバルク インサート
• Markdownからコンテンツ情報とmeta情 報をパースしてElasticsearchにバルク インサート • ネイティブのSearch Box(client fuzzy search)をscoringベースのESバックエ ンドに差し替え
→ 検索精度向上
• Markdownからコンテンツ情報とmeta情 報をパースしてElasticsearchにバルク インサート • ネイティブのSearch Box(client fuzzy search)をscoringベースのESバックエ ンドに差し替え
→ 検索精度向上 • 全文検索APIをカスタマーサポートにも 利用予定(開発中)
おまけ
Other Works プレビュービルド Staging Env モニタリングツールを利用し たアクセス・行動分析 Analytics 英語/韓国語/日本語 i18n
積極的なNuxt Contentへの コントリビュート + patch運用 OSS 顧客満足度サーベイの実施 RFC Process Community 全員参加型の改善提案 アクティビティ Workshop
ユーザーと開発者の”楽しい”のために
Thank you!!