GitLabに学ぶ パフォーマンスを最大化させるドキュメンテーション技術 数千ページにもわたるハンドブックを活用したテキストコミュニケーションの作法 | 翔泳社
世界最大のリモート組織が実践する徹底したドキュメント化の手法 本書は、世界でも有数のドキュメント作成ノウハウを持っているGitLabを参考にした「ドキュメント作成」や「テキストコミュニケーション」の入門書です。 同社は、世界65カ国に2,000名を超えるメンバーが所属しているグローバルカンパニーです。 世界中のあらゆる場所や価値観、タイムゾーンに存在するメンバーのパフォーマンスを引き出すためには、ドキュメントが鍵であると同社は述べています。 情報が蓄積されたドキュメントが存在することで、必要な情報にいつでも多くの人がアクセスでき、信頼性の高い情報をベースに業務が進められます。 本書では、このような効果的なドキュメントがどうすれば作成できるのか、GitLabのドキュメント作成ノウハウに基づいて解説します。 また、GitLabのドキュメント作成方法はかなり具体的なルールや手法が示されていますが
社内のソースコードをGitHub Enterprise にとりまとめてる話 - NTT docomo Business Engineers' Blog
みなさんこんにちは、社内のエンジニアが働きやすくすることを目標にする Engineer Empowerment プロジェクトの @Mahito です。 この記事は、NTT Communications Advent Calendar 2021 2日目の記事です。 今回は社内のソースコードを GitHub Enterprise にとりまとめる活動とそこで遭遇した課題と解決方法についてお話します。 背景 きっかけは「NeWork のソースコードが見たい」という私の思いつきでした。 これを私が言い出した 2020 年当時、NTT Com ではソースコード管理の方法に決まりはなく、各プロジェクトの判断でバラバラにソースコードリポジトリが導入されていました。ちなみに、私が社内で見かけただけでもソースコードのホスティング先には以下のようなものがありました。 GitHub (Team plan) Git
ウクライナ発個人プロジェクトGitLabが1兆円規模のIPOへ、その4つの教訓 | Coral Capital
ウクライナのソフトウェア開発者Dmitry Zaporozhets氏が2011年10月に、たった1人で開始したオープンソースプロジェクト「GitLab」。それが、ちょうど10年を経て時価総額1兆円もうかがうほどの大成功したDevOpsのSaaSプラットフォームへと進化することになると想像した人は、ほとんどいなかったと思います。GitLabのライセンス・SaaSビジネスを展開するGitLab Inc.は9月17日付けで米国証券取引委員会（SEC）に対してFORM S-1を提出し、IPOへ向けて最終段階に入りました。 開発初期から生まれたモメンタムと、それを生かした分散開発の組織化、VC投資を組み合わせた株式会社としての成長といったことから学べることは少なくないと思います。この記事では、GitLabの成功から学べる4つの教訓について書いてみたいと思います。 DevOpsという言葉が広まる前にス
The problem with Git flow
Sometimes, you can have too much of a good thing. That’s certainly true with Git flow, a well-known software development workflow that offers several options but can bog down users. We developed GitLab Flow as the solution to eliminate messy complexity and streamline the development process. GitLab Flow brings issue tracking to the Git workflow, simplifying the process and removing confusion. The
Git15周年 - GitHubとGitLabに聞く
あなたにとって重要なトピックや同僚の最新情報を入手しましょう最新の洞察とトレンドに関する最新情報を即座に受け取りましょう。 継続的な学習のために、無料のリソースに手軽にアクセスしましょうミニブック、トランスクリプト付き動画、およびトレーニング教材。 記事を保存して、いつでも読むことができます記事をブックマークして、準備ができたらいつでも読めます。
GitLab的ドキュメント文化を組織にインストールする（実践編:スタートアップMNTSQの事例）｜安野貴博
会社組織にドキュメント文化をインストールすることの有用性や、GitLabのような企業がどのようにドキュメントを運用しているかを、前回記事で書いた（スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ）。今回は、私のいるスタートアップのMNTSQ（モンテスキュー、と読みます）でどのようにそれを実践しているか、実際のところどのような成果が出ているのかについて書いてみたい。 MNTSQでは、当初からドキュメンテーションの重要性を経営メンバー全員で認識しており、社内ドキュメントをGitHub管理でメンテナンスしながら作り上げていくようにしていた。この大枠の仕組みの設計部分は弊社のデザイナーの生谷(@ikutani41)が初期に考案/メンテしたものである。デザイナー視点からこのような仕組みが設計され稼働されることは珍しいと思う。この辺については本人からもどう
BlogやるならGitLab Pagesがおすすめ | κeenのHappy Hacκing Blog
κeenです。 GitHub Pagesからこんにちは。 私はこのGitHub Pagesのブログの他にGitLab Pagesのブログも持ってるんですが、それが使いやすいので宣伝します。 GitLab Pagesを使うと Markdownでブログがかける Markdownのまま git push で記事の公開ができる コンテンツの管理が(GitHub Pagesより)楽 サイトでHTMLやJavaScriptが使い放題 になります。 JavaScriptが自由に使えるということは私のようにreveal.jsなどのスライドエンジンを使ってMarkdownでスライドを書いて公開することもできます。 ブログに自由度が欲しいという方におすすめです。 GitHub PagesとGitLab Pages GitHub PagesとGitLab Pagesはだいたい似たようなことができます。 ユーザの
スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ｜安野貴博
ドキュメント文化は健全な組織のスケールのために必要 組織の中でドキュメント/文章を残し活用していくことはとても重要だ。クオリティの高いドキュメントがあることで、組織に情報が流通し、透明性を確保できるようになる。情報を流通させるためにいちいち口頭の説明がいらないから、メンバーの数が増えた時でもスケールしやすくなる。過去の結論にアクセス可能になるので、議論を積み上げていき、意思決定のクオリティを高めることにもつながる。そもそも何かを読むということは何かを聞いて教わるよりも時間あたりの処理量が多いし、非同期に実施できる。良いドキュメントをアセットとして社内に蓄積していくことはスタートアップのみならず、ありとあらゆる組織が成長していく上でとても重要であると言える。 しかしその一方で、良質なドキュメント文化を徹底できている会社は多くないように見える。例えば、社内のドキュメントを蓄積させていく場所とし
Software Design 2020年1月号のGitLab特集に寄稿させて頂きました #gihyosd - くりにっき
商業誌デビューです！ gihyo.jp きっかけ GitLab.JP の @hiroponz79 さんにお声がけいただいて参加することになりました。 僕の担当について GitLab特集は全3章構成なのですが、僕は第3章の「自前でGitLabを管理するために知っておかなければならないこと」というタイトルで寄稿させて頂いています。 「自前でGitLabを管理するために知っておかなければならないこと」というタイトルの通り、僕の知ってるGitLab運用の知見を余すところなく書いています。 当初の予定だと GitLab令和最初のリプレイス。フルコンテナ化ポスグレ移行 - pixiv inside を深掘りした内容を書くつもりだったのですが、気づいたら全く別ベクトルのGitLab運用の話になって8〜9割くらい新規に書いていました。 GitLabが巨大なRailsアプリということもありどのRailsアプ
MkDocs+GitLab-CI+wkhtmltopdf でドキュメント更新作業の煩雑さから解き放たれる｜Mars
マニュアルの管理運用をやってるのですが、WORD だったり PPT だったり Sphinx だったりで作った資料をGドライブに格納して社外向けに配るときは PDF を zip してパスかけて BOX にあげて共有用 URL をメールで送って、解凍パスワードを別送するとかもう嫌だ！ と思ったので、これからのスタンダードはこれにすると決めたときにやったこと。 🍄 前提Windows 利用者向け 🍄 MkDocs を使える環境を整えるMkDocs は markdown 形式で簡単にドキュメントが作成できるツール。無料です。 python がいります。2.x 系でも 3.x 系でも。なければインストールを。 $ python --version Python 2.7.12pip で mkdocs をインストールするので、存在しているか確認。 $ pip --version pip 9.0.1
Excel運用からAnsible TowerとGitLab運用に変更してどう変わったかまとめてみた | 日常系エンジニアのTech Blog
Ansible TowerとGitLabを入れてどういう運用を実現したかったかを簡単な例と一緒にまとめてみようと思います。（自分への備忘録含め） ここに書くこと ここでは Ansible Night in Tokyo 2019.04 で話をした中のLinuxサーバ運用編ついてもう少し詳細に書いてみようと思います。 ここで言う運用のイメージは 定常運用 です。 Excel運用課題の振り返り ファイルの管理が「yyyymmdd」などファイルの末尾で管理されていたりしてどれが最新か分かりにくい 手順書の変更履歴が表で管理されていて文字しか書いていなくて before after が分かりにくい レビューシートが手順書ごとに出来ていく、これも日付管理されたり文字で書いてあるだけなので実際にどう修正したのかが残らない 手順書フォーマットは統一されているが、人によって手順の内容がバラバラ 「このファイ
GitLab CI + docker-reviewを使って、Markdownをtextlintしてからpdf化するCI環境を作ってみた - メモ的な思考的な
最近、Markdownからpdfを作る機会がありました。 pdf化を都度行うのは手間だったため、何か良い方法がないかを探したところ、 Markdown > Re:VIEW > pdf という経路でpdfを作成できそうでした。 ただ、手動でpdfを生成するのが手間だったため、GitLab CIを使って、push後にMarkdownをtextlintしてからpdf化するCI環境を作ってみました。 目次 環境 GitLab CIの設定ファイル .gitlab-ci.yml の作成 ステージを定義 ジョブを定義 ジョブ「対象のMarkdownにtextlintを実行」の詳細を定義 ジョブ「Markdownをpdf化する」の詳細を定義 textlint向けの定義 prh.yml .textlintrc review-pdfmaker向けの設定 config.ymlの設定 pdf化するコンテンツの設定
Hugo+GitHub Pagesで作ってるブログ運用をGitLabからCircle CI+GitHubに切り替えました。 | dotstudio
Hugo+GitHub Pagesで作ってるブログ運用をGitLabからCircle CI+GitHubに切り替えました。 こんにちは、代表のn0bisukeです。 タイトル通り、dotstudioのブログの構成を変更したのでメモを残しておこうとおもいます。 今までの構成とデプロイの流れ基本は静的サイトジェネレーターのHugoを利用しています。 基本はHugoで手元でビルドしてGitHub Pagesでデプロイするという流れです。 CIを特に利用しないでやってて大変さがありました。 GitLab CIの限界があったGitLabを内部では利用していたので、GitLab CIでビルドをいい感じにしようかとしていたらハマりました。 Running with gitlab-runner 11.7.0-rc1 (6e20bd76) on docker-auto-scale ed2dce3a Usin
どのクラウドでも使えるサーバレス「GitLab Serverless」をGitLabが発表。KubernetesとKnativeがベース
どのクラウドでも使えるサーバレス「GitLab Serverless」をGitLabが発表。KubernetesとKnativeがベース GitLab ServerlessはKnativeをベースにKubernetes上で稼働するサーバレスプラットフォームです。GitLabがホスティングするのではなく、AWSやGoogle Cloud Platformなどどのクラウドに対してもデプロイし使えることが最大の特徴と言えるでしょう。 GitLabはマルチクラウドに対応したサーバレス管理ツールを提供するTriggerMeshと協力することで、デプロイ後の運用まで一貫してGitLabで管理できるとしています。 現在、AWS LambdaやGoogle Cloud Functions、Azure Functionsなど主要なクラウドは独自のサーバレスプラットフォームを提供しています。しかしそれぞれのク
プライベートDockerレジストリとしてのGitLab Container Registry - Qiita
GitLab Registryという選択肢 Dockerイメージの管理(registry)にDockerHubやGCR，ECRなど のサービスを利用している人も多いかと思いますがやはりローカル環境(オンプレミス環境)で Registryサービスを構築して利用したいという人も多いと思います． そいういうときの選択肢としてはDocker Registryが始めに挙がると思いますが， 残念ながらOSS版のRegistryにはユーザ認証機能などがなく， 便利な機能は有償のDocker EEで提供されるDocker Trusted Registryを利用する必要があります． では代替として何があるかというと，CNCFプロジェクトの1つとなったHarborがあります． Harborにはユーザ認証機能はもちろん，脆弱性検査などの機能もあり非常に便利ですが 運用がそれなりに面倒という課題があります． 自分
GitLabと他のツールとの比較 | GitLab.JP
チームとAIエージェントの連携方法を定義開発、テスト、セキュリティ、デプロイメント向けのワークフローをカスタマイズできます。チームはソフトウェアライフサイクルの上位からオーケストレーションを行い、AIエージェントはその中でタスクを実行し、設定したルールとガードレールに基づいて反復的なタスクを自動化します。エージェントはイシューをマージリクエストに変換し、脆弱性を修復し、コードをレビューします。その一方で、チームは常に主導権を維持します。 エンドツーエンドのDevOpsプロセスを1つの場所で計画からソースコード管理、CI/CDまで、ソフトウェアをより速く構築・リリースするために必要なすべてが1つのプラットフォームに揃っています。プロジェクト、リリース、コードなどすべてのデータが単一のデータプレーンに集約されているため、チームとエージェントが信頼できる唯一の情報源から作業できます。 セキュリテ
GitLab Development KitをMac OS直で使う
GitLab Development KitをMac OS Nativeで使う GitLabはオープンソースで誰でもコントリビュートできます。そのために以下のGitLab Developer Kitが公開されています。 Macユーザにはパフォーマンスの観点からVM上ではなくMac OS直にインストールすることが推奨されています。GitLab CEにコントリビュートする想定でインストール手順と落とし穴をまとめました。 Rubyバージョン 以下のページから必要なRubyバージョンが確認できます。現時点で 2.4.4 となります。 2018/11/14時点でRuby 2.5.3 になったことを発覚。 自分はrbenvを使っていますのでそれでバージョンをあわせます。 > ruby -v ruby 2.4.2p198 (2017-09-14 revision 59899) [x86_64-darwi
GitLab no longer requires NFS: The road to Gitaly v1.0
In the early days of GitLab.com, most of the application, including Rails worker processes, Sidekiq background processes, and Git storage, all ran on a single server. A single server is easy to deploy to and maintain. The same structure is what most smaller GitLab instances still use for their self-managed Omnibus installation. Scaling is done vertically, meaning; adding more RAM, CPU, and disk sp
Simple deployment to Amazon EKS
UPDATE: As of GitLab 12.5 you can create EKS clusters from GitLab using the EKS Integration Recently, Amazon announced that Elastic Container Service for Kubernetes (EKS) is generally available. Previously only open to a few folks via request access, EKS is now available to everyone, allowing all users to get managed Kubernetes clusters on AWS. In light of this development, we’re excited to announ
How we used GitLab CI to build GitLab faster
GitLab is an open source project, but also a commercial project. For historic reasons, we have two Git repositories: gitlab-ce for GitLab Core and gitlab-ee for GitLab Enterprise packages (you can read our recent blog post explaining GitLab self-managed tiers). While we're working on having a single codebase, we still need to regularly merge gitlab-ce into gitlab-ee since most of the development h
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
