バージョン管理

CARTA TECH BLOG アドベントカレンダー 12月15日分の投稿です。 みなさんこんにちは、サポーターズの @y_chu5 （ちゅうこ） です。 普段はTypeScriptでWebフロント、ScalaでAPIサーバーのコードを書いたり、CIを整備しています。 さて、みなさんはこんな経験はないでしょうか。 『cloneして動かそうとしたらビルドが通らない』、『何もしてないのにテストが落ちるようになった』、『キャッシュ消したらアプリが壊れた』… この記事では、OSSを使う側、作る側両方に立ってみて見えたバージョン固定の重要さを少しお話したいと思います。 これからお話する内容は、例えば言語…

開発者がよく作業上で使っている言語のツールチェインを変えたりはします。 最新版のプロジェクトなら、ほとんどの場合はツールチェインの最新版で実装されるだろう。 けれど、X年前からずっとサポートしないといけないプロジェクトもあります。 結局プロジェクトそれぞれ別のツールチェインに依存するのが珍しくありません。 おそれるな！バージョン管理ツールのお出ましだ！ 幸いに、もうほとんどの言語のツールチェインがバージョン管理ツールをサポートしています。 はい、問題解決。 記事終わりです。皆さんありがとうございました。 と言いたいが、言語ごとバージョン管理ツールを使わなければなりません。 Pythonなら、p…

はじめに ２０７株式会社でデザイナーをしております。KUMIKOと申します。 207 Advent Calendar に参加するため、久々にお仕事のブログを書かせていただくことになりました。こちらは７日目の記事になります！！ 背景と問題点 ２０７には私が10月入社するまで正社員のデザイナーがいませんでした。 スタートアップの会社にはよくあることで、自社アプリのデザインは業務委託のデザイナーが入れ替わりで入って制作をして、委託のデザイナーが稼働していない日などはPdMやエンジニアさんがデザインを行なっていたそうです。 そのため、Figmaのデザインファイルは色々な場所で作られ、ファイルを管理する…

これは「Git、GitHubの使い方」の５回目になります。 はじめから読んでみたいという方はこちらになります。 kuku81kuku81.hatenablog.com 全体を通して一通りの手順を見たいような場合はこちらに記載しています。 kuku81kuku81.hatenablog.com それでは本題になります。 Gitでバージョン管理を行いたい場合には、gitをインストールした後に、リポジトリの初期化を行います。 リポジトリとは、「ファイルやディレクトリの状態、変更履歴などを記録しておく場所」です。英語では、「貯蔵庫」、「収納庫」というような意味です。 gitで管理したいディレクトリを決…

pyenvはPythonのバージョンを管理してくれるツールです。 インストールにはHomebrewを利用して行います。 まだHomebrewをインストールしていない方は以下の手順でインストールしてください。 mrradiology.hatenablog.jp pyenvをインストールします。 ターミナルを起動し、以下のコマンドを実行してください。 brew install pyenv pyenvインストール ログイン時にpyenvの初期化をおこなうようにします。 viエディタで「.bash_profile」ファイルを編集します。 ターミナルで以下のコマンドを実行してください。 vi ~/.b…

はじめに GitHubでリリースノートを作る方法についての記事です。 はじめに リリースノートとは 環境 タグをつける GitHubでリリースノートを作成する 作成する頻度やタイミングは？ おわりに リリースノートとは 機能や不具合修正のログに関するノートのようなものです。 Gリリースノートを作成すると以下の事ができます ログが見れる 前回からの差分を確認 プロジェクト一式をダウンロード(各バージョンごとの) 環境 この記事の情報は次のバージョンで動作確認しています。 MacOS Monterey (12.1) Sourcetree (4.1.1) タグをつける まずリリースするコミットに対し…

はじめに 今日はGitHubの小技についてです。 GitHubでリポジトリを作った後に、「あっいっけね、スペルミスしてるわー泣」 ってことありませんか？ これ直すの大変なんだろうなーと思いきやそうでもなかったので、共有します。 GitHubでリポジトリ名を正す GitHubにアクセス Settings をクリック Repository mame の名前を変更して Rename します これでGitHub側の設定は完了となります。 GitHubだけ直しても完了ではなく、参照するURLが変わってしまうことでGitクライアントソフト側の修正も同時に必要となります Gitクライアントソフトでの対応 S…

技術書典14の新刊として『オブジェクト・ウォーズ』を書いた。 このとき、組版システムとしてVivliostyleを使ってみたので、その感想とか。 Vivliostyleとは 本を作ろうとすると文章のレイアウト（組版）が必要になって、そのために使われるのが組版システム。 やInDesignなどいろいろなソフトがあって、自分も独自のシステムを作ってみたりしてるんだけど、Vivliostyleもそんな組版システムの一つ。 Vivliostyleの特徴はレイアウトの指定をWebページと同じようにCSSでできるようにしていること。 これによりWebページを作るときのテクニックが流用できるというメリットが…

いま、開発中の作業で、一度実装した機能が仕様変更でなくなったのに、その後また復活するということがありました。 まあ、これ自体はよくある話なうえに、そういう予感もしていたので、そんなに問題ないく対応できました。 ですが、いまの作業のやり方って、開発と並行してマニュアルも修正してるんで、マニュアルも復活させた内容に差し戻す必要が出てきました。 一度は実装した機能についてマニュアルを書いたんですが、この機能がなくなったタイミングでこちらも当然削除してます。マニュアルは開発コードほどはこまめにバックアップを取っていなかったため、前に書いた内容に対応するファイルが見当たらなくなってしまいました。 困った…

僕はRubyで何かしら開発をする時にbinding.pryというデバッグツールを愛用してきました。 Rubyを書き始めたのが確か、2.3系の頃で当時からbinding.pryは非常に人気のデバッグツールでした。 しかし、Rubyのバージョンアップにつれてbinding.irbが標準gemとなりインストールをしなくても使用可能になったため、最近はbinding.irbを使うようになりました。 しかし、なぜかコード中にbinding.irbと挿入してIRBは立ち上がるものの、debugと入力してもエラーが表示され、デバッグ画面に遷移できませんでした。しかし、プライベートで使っているPCではdebu…

どんな内容？ platformIOというVisualStudioCode(vscode)用の拡張機能を用いて、mbed-os5の開発環境を作成する。 マイコン開発をvscodeを使って開発したい人には参考になると思う。 前提 自分が使っているマイコンはLPC1768搭載のもの 条件を同じにすると、チップの差による不具合は起きにくくなると思うので、よければ試してみてほしい NXP MBED NXP LPC1768搭載マイコンモジュール 【OM11043-598】 NXP MBED NXP LPC1768搭載マイコンモジュール 1個 OM11043-598 手順 1. git導入 概要 git：バ…

このエントリでの「API」はHTTP APIです。Javadocなどでドキュメント化できるAPIではないです。この件に関してはいつかブログとか書くかもだけど、いまは ツイートを参照してください。 SpringBoot 3.1.0 springdoc-openapi 2.1.0 springdoc-openapi-gradle-plugin 1.6.0 できるようになること ./gradlew generateOpenApiHtml このコマンドを実行するだけで ./build/redoc-static.html ができます。この子は「zero-dependency HTML」なので適当な場所に…

概要 コードをよりよく読むために 混乱タイプ コードの速読 人間の短期記憶の容量 記憶のサイズ制限を克服する コメント 言語の関数を覚えるのが難しい理由と覚える必要がある理由 割り込み 文法の覚え方 記憶定着させるテクニック 精緻化 スキーマ 記憶を長く保つためのコツのまとめ 複雑なコードの読み方 認知負荷 課題内在性負荷 課題外在性負荷 リファクタリング 認知度を下げる 変数が持つ役割 ハンガリアン記法 モデル メンタルモデル 想定マシン スキーマの重要性 二つ目のプログラミング言語を学ぶことは一つ目より簡単 デメリット 概念変化 防ぎ方 ルール 三つのステップモデル コードの臭い 言語的ア…

情報処理安全確保支援士（登録セキスペ）試験を受験する方向けに、午前Ⅱ対策を中心としたチートシートを用意しました。 こちらは、あくまで試験合格を目的とした内容になっていますので、きちんと学習したい方は、過去問題解説ページ等をご覧ください。 当ページの内容は動画（YouTube）でも公開していますので是非ご利用ください。 (adsbygoogle = window.adsbygoogle || []).push({}); 試験別 午前Ⅰ 同時開催の応用情報技術者試験午前問題と同じ問題が出題されます。（80問中30問）よって、対策は応用情報技術者のページを参考にしてください。 なお、午前Ⅰは応用情報…

なんとなく、GitHubのプライベートリポジトリにrita.xyzのデータをアップロードしてみるなどした。将来のrita.xyzのCloudflare Pages移行に備えて、という意味合いもある。内部的にGitでバージョン管理していたのでremoteのoriginを設定した上でpushするだけで終わる。なお今の慣例に従いブランチ名もmasterからmainに変更している。rita.xyzのCloudflare Pages移行の際はダウンタイムが若干生じると思うので別途告知予定。

■ はじめに https://dk521123.hatenablog.com/entry/2023/05/03/000000 より分冊。 Terraform の Module について扱う。 目次 【１】モジュール - module 【２】モジュール化の一例 【３】モジュール種類 １）ローカルモジュール ２）リモートモジュール 【４】Terraform Registry １）Verifiedモジュール ２）Communityモジュール 【５】構文 １）呼び出し 【６】サンプル １）フォルダ構成 ２）TFコード ３）動作確認 【１】モジュール - module * 単一のディレクトリにあるTer…

こんにちは、ヘンリーの SRE の戸田と VPoT の岩永です。 弊社ではレセコン一体型クラウド電子カルテの Henry を開発・提供しています。 前編の Henry のバックエンドをモノレポ化した戦略やプロセスに続いて、後編のこちらの記事ではモノレポ化の技術的手法を解説します。 dev.henry.jp 実際のモノレポ化の流れに沿って、ポイントを3点説明します。 2つの git リポジトリのマージ アプリケーション・ワークフローのモノレポ対応 モノレポへの切り替え当日に向けた手順書の作成 1. 2つの git リポジトリのマージ 今回のモノレポ化においては、もともと存在していた henry-…

提供する機能とは関係なくリリースを定期的に実施するようなプロダクトや、バージョンにSemantic Versioning（以下SemVer）のような意味付けがしにくいプロダクトの場合、バージョン管理手法にCalendar Versioning（以下、CalVer）というものが採用されることがあります。 calver.org 例えば、CalVerのサイトに掲載されているケーススタディで私が知っていたものとしてはUbuntuのバージョニング（ YY.0M.MICRO ）があります。 22.04 とか 22.10 とかのアレです。 そしてちょうど私がバージョニングしたいプロダクトも 1ヶ月に1度定期…