<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[KAUCHE Tech Blog - Medium]]></title>
        <description><![CDATA[株式会社カウシェのProductチームによる技術ブログです。私たちと一緒に世界一楽しいショッピング体験をつくりませんか？ - Medium]]></description>
        <link>https://medium.com/kauche?source=rss----14577f02028b---4</link>
        <image>
            <url>https://cdn-images-1.medium.com/proxy/1*TGH72Nnw24QL3iV9IOm4VA.png</url>
            <title>KAUCHE Tech Blog - Medium</title>
            <link>https://medium.com/kauche?source=rss----14577f02028b---4</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 07:37:03 GMT</lastBuildDate>
        <atom:link href="https://medium.com/feed/kauche" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[カウシェにおける Cloud Run のネットワーク構成のこれまでとこれから]]></title>
            <link>https://medium.com/kauche/cloud-run-network-ac1ccf7dc33d?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/ac1ccf7dc33d</guid>
            <dc:creator><![CDATA[Yuki Ito]]></dc:creator>
            <pubDate>Mon, 04 Dec 2023 04:34:21 GMT</pubDate>
            <atom:updated>2023-12-04T04:34:21.776Z</atom:updated>
            <content:encoded><![CDATA[<p>こんにちは、株式会社カウシェの Architect かつ Google Cloud Champion Innovator（Modern Architecture と Serverless App Development の分野）の伊藤です。<br>本稿では、Google Cloud が提供するサーバーレスなコンテナ実行環境である <a href="https://cloud.google.com/run">Cloud Run</a> のネットワーク構成について、「カウシェにおける現状の構成」と「Cloud Run の新機能を利用した今後の改善」を解説します。</p><h3>Cloud Run のサービス間通信</h3><p>カウシェでは Cloud Run を用いてマイクロサービスを構築しています。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FDtsb87PGikRd9PXASqjAQ.png" /><figcaption>カウシェにおける Cloud Run 上のマイクロサービス</figcaption></figure><p>上図の場合、「Service A」は他のマイクロサービスからの通信を受け付ける必要はありますが、インターネットから直接通信を受け付ける必要はないので、<a href="https://en.wikipedia.org/wiki/Principle_of_least_privilege">Least Privilege</a> の考え方に基づいてインターネットからの Service A へのアクセスを禁止すべきです。</p><p>Cloud Run にデプロイされたサービスはデフォルトではインターネットからアクセスが可能な状態になりますが、<a href="https://cloud.google.com/run/docs/securing/ingress">Ingress のネットワーク設定</a>を変更することでサービスへのインターネットからのアクセスを禁止することもできます。具体的には、Cloud Run は下記の 3 つの Ingress の設定を提供しています:</p><ul><li><strong>Internal</strong><br>- 同一 VPC Network 内などの内部通信のみを許可<br>- 「内部通信」の定義については <a href="https://cloud.google.com/run/docs/securing/ingress">Ingress の設定に関するドキュメント</a> に記載されています</li><li><strong>Internal and Cloud Load Balancing</strong><br>- 上記の「Internal」に加えて、External Application Load Balancer からの通信も許可</li><li><strong>All</strong><br>- インターネットからの通信を含む、すべての通信を許可</li></ul><p>カウシェのマイクロサービスは <a href="https://microservices.io/patterns/apigateway.html">API Gateway Pattern</a> を用いて構成しているので、すべての通信は External Application Load Balancer を経て API Gateway サービスが一次的に受け付けます。そのため、カウシェでの Cloud Run サービスの Ingress の設定は、API Gateway サービスだけが「Internal and Cloud Load Balancing」に設定されており、それ以外の全てのサービスは「Internal」に設定されています。これにより、不必要なインターネットからの Cloud Run サービスへのアクセスを遮断することが可能となります。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*I5oYa4C17aUKUFAPyPjcSw.png" /><figcaption>Ingress の設定による通信の制御</figcaption></figure><p>カウシェでは、Cloud Run のサービス間通信を「Internal」にするために、すべての Cloud Run サービスを VPC Network に所属させています。</p><h3>Shared VPC Network と VPC Service Controls Perimeter</h3><p>Google Cloud で VPC Network を構築する方法には、単一の Google Cloud Project 上に VPC Network とそれに所属するリソースを配置する「Single VPC Network」と、VPC Network とそれに所属するリソースを異なる Google Cloud Project 上に配置する「Shared VPC Network」の 2 つのパターンが存在します。</p><p>カウシェでは、<a href="https://cloud.google.com/architecture/best-practices-vpc-design#single_vpc_network_and">Google Cloud が提供する VPC デザインに関する Best Practices</a> を鑑みつつ、「VPC Network を Platform Team で一元的に管理したい」という考えから Shared VPC Network を採用しています。具体的には、VPC Network を管理するための専用の Google Cloud Project を Shared VPC Host Project として構築し、Cloud Run とその他のリソースは Shared VPC Service Project として異なる Google Cloud Project に配置しています。</p><p>この Shared VPC Network に Cloud Run サービスを所属させるため、<a href="https://cloud.google.com/vpc/docs/serverless-vpc-access">Serverless VPC Access Connector</a> を利用しています。Serverless VPC Access Connector は Cloud Run や Cloud Functions といったサーバーレス環境を VPC Network に接続させるためのコンポーネントです。<a href="https://cloud.google.com/vpc/docs/configure-serverless-vpc-access">Cloud Run サービスのデプロイ時に Serverless VPC Access Connector を利用するように設定</a>し、Cloud Run サービスからの Egress 方向のすべての通信を Shared VPC Network を経由するように構築しています。</p><p>また、Shared VPC Network を経由する Cloud Run のサービス間通信を「Internal」扱いにするために、<a href="https://cloud.google.com/vpc-service-controls/docs/service-perimeters">VPC Service Controls Perimeter</a> を利用しています。VPC Service Controls Perimeter は Google Cloud 上のリソースから不正に情報が漏洩することを防止するための機能です。Cloud Run で Shared VPC Network を用いる場合、同一の VPC Service Controls Perimeter 内に Shared VPC Host Project と Shared VPC Service Project が配置されている場合にサービス間通信が「Internal」として扱われます。</p><p>まとめると、カウシェにおける Cloud Run のネットワークは、Shared VPC Network、Serverless VPC Access Connector、VPC Service Controls Perimeter を利用して下図のように構成されています。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fBSs2BcFabZHlvMN1c_sbQ.png" /><figcaption>Shared VPC Network、Serverless VPC Access Connector、VPC Service Controls を利用した Cloud Run のためのネットワーク構成</figcaption></figure><h3>今後の改善</h3><p><strong>Direct VPC Egress を用いた VPC Network への接続</strong></p><p>カウシェでは Serverless VPC Access Connector を用いて Cloud Run サービスを VPC Network に接続していると解説しましたが、Serverless VPC Access Connector はそれ自体の死活監視などの管理コストを必要とします。<a href="https://cloud.google.com/run/docs/release-notes">2023 年 8 月にリリース</a>された <a href="https://cloud.google.com/run/docs/configuring/vpc-direct-vpc">Direct VPC Egress</a>（この記事の執筆時点では Preview）を利用することで、この Serverless VPC Access Connector なしで Cloud Run を直接 VPC Network に接続させることが可能となりました。今後は <a href="https://cloud.google.com/run/docs/configuring/connecting-vpc">Google Cloud が解説する各 VPC Network 接続方法のメリット・デメリット</a>を鑑みつつ、Direct VPC Egress を用いたシンプルな構成で Cloud Run サービスを VPC Network に接続したいと考えています。</p><p><strong>VPC Service Controls Perimeter を必要としない「Internal」なサービス間通信</strong></p><p>Shared VPC Network を経由した Cloud Run のサービス間通信を「Internal」扱いにするために VPC Service Controls Perimeter を利用している、と解説しましたが、<a href="https://cloud.google.com/run/docs/release-notes#April_20_2023">2023 年 4 月</a>から VPC Service Controls Perimeter を利用しなくても Shared VPC Network を経由した通信が「Internal」として扱われるようになりました（<a href="https://cloud.google.com/run/docs/release-notes#October_11_2023">2023 年 10 月</a>にこの機能は GA になっています）。VPC Service Controls Perimeter は多重的な防御として有用ですが、権限管理や構築のコストが増えるので、セキュリティ的な懸念も考慮しつつ VPC Service Controls Perimeter を利用しない構成に変更しても良いのでは、と考えています。</p><h3>おわりに</h3><p>本稿では、カウシェにおける Cloud Run のネットワーク構成について、Cloud Run が提供するネットワークの機能の解説を交えつつ紹介しました。Cloud Run は、ネットワークの他にも<a href="https://cloud.google.com/run/docs/deploying#sidecars">サイドカーコンテナのサポート</a>など、便利な機能が続々とリリースされているので今後の機能追加も楽しみです。この記事が、みなさまの Cloud Run のネットワーク構築の一助となれば幸いです。それでは。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ac1ccf7dc33d" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/cloud-run-network-ac1ccf7dc33d">カウシェにおける Cloud Run のネットワーク構成のこれまでとこれから</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Go Conference 2023 にカウシェのスポンサーブースを開設します！]]></title>
            <link>https://medium.com/kauche/go-conference-2023-73ce29dc0ce8?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/73ce29dc0ce8</guid>
            <category><![CDATA[go]]></category>
            <dc:creator><![CDATA[Yuki Ito]]></dc:creator>
            <pubDate>Thu, 01 Jun 2023 13:23:10 GMT</pubDate>
            <atom:updated>2023-06-01T13:27:58.438Z</atom:updated>
            <content:encoded><![CDATA[<p>こんにちは、株式会社カウシェの Platform Team に所属する Architect の伊藤です。</p><p>来る 6 月 2 日に開催される <a href="https://gocon.jp/2023/">Go Conference 2023</a> に、カウシェとしてスポンサーブースを開設します！スポンサーブースは reBako というサービスを用いてオンライン上で開催され、スポンサー各社のブースを自由に周遊できるようになっています。</p><p>カウシェのブースでは、カウシェ風のマイクロサービスを OSS として公開している <a href="https://github.com/kauche/kauche-microservices-example">kauche-microservices-example</a> リポジトリを題材に、下記のような内容を解説できればと思っています:</p><ul><li>カウシェ社内での Go の利用</li><li>カウシェで利用している Go のライブラリ</li><li>Go + GraphQL Federation</li><li>Go + gRPC</li><li>API Gateway としての Envoy</li><li>カウシェでの WebAssembly の利用</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zVUvo6BK2wfEJemCv8kyQg.png" /><figcaption>KAUCHE のアーキテクチャ</figcaption></figure><p>また、他にも カウシェで利用している Cloud Run を始めとした Google Cloud についてや、Go の開発環境、<a href="https://github.com/kauche">カウシェから公開している OSS 群</a> の解説など、なんでもお話できればと思います！</p><p>Go をこれから始めようと思っている方から、すでにバリバリ利用されている方まで、幅広く楽しめるような内容になっていると思うので、ぜひカウシェのブースにお越しいただければと思います。</p><p>それでは、当日スポンサーブースでお会いしましょう！</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=73ce29dc0ce8" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/go-conference-2023-73ce29dc0ce8">Go Conference 2023 にカウシェのスポンサーブースを開設します！</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Cloud Run Casual Talk! #2 を開催しました！]]></title>
            <link>https://medium.com/kauche/cloud-run-casual-talk-2-4a25199456c?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/4a25199456c</guid>
            <category><![CDATA[google-cloud-run]]></category>
            <category><![CDATA[opentelemetry]]></category>
            <dc:creator><![CDATA[Yuki Ito]]></dc:creator>
            <pubDate>Wed, 17 May 2023 08:33:31 GMT</pubDate>
            <atom:updated>2023-06-01T13:03:43.991Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/660/1*VMRAKzuc4DhAWLwHeMqFRQ.png" /><figcaption>Cloud Run Casual Talk！#2 〜Reliability/Observability にDeep Dive！〜</figcaption></figure><p>こんにちは、株式会社カウシェの Platform Team に所属する Architect の伊藤です。</p><p>本稿では、先日開催した「Cloud Run Casual Talk！#2 〜Reliability/Observability にDeep Dive！〜」というテックイベントについて内容を簡潔にまとめます。動画のアーカイブが YouTube 上で閲覧できるので、そちらも合わせてぜひご覧ください！</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FIcDA-va1-Po%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DIcDA-va1-Po&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FIcDA-va1-Po%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/6483df71fba48c4979bcae08fad849ac/href">https://medium.com/media/6483df71fba48c4979bcae08fad849ac/href</a></iframe><h4>Cloud Run Casual Talk! とは</h4><p>「Cloud Run Casual Talk!」は、<a href="https://cloud.google.com/">Google Cloud</a> が提供しているマネージドなコンテナ実行環境である <a href="https://cloud.google.com/run">Cloud Run</a> を利用している企業のエンジニアが事例を解説し、パネルディスカッションでさらに深堀りしていくイベントです。今回は、発起人であるカウシェ所属の筆者と、Cloud Run をヘビーに活用されているソウゾウ所属の <a href="https://twitter.com/dragon3">dragon3 さん</a>から、Cloud Run の活用事例について、特に Reliability や Observability の向上にフォーカスして解説しました。</p><h4>カウシェからの事例紹介</h4><p>カウシェからは「Cloud Run における Cloud Logging / Cloud Trace の利用方法」や「OpenTelemetry を活用した Cloud Monitoring への Metrics の出力」について紹介しました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IbesNDggmEPeY8_Nr6cozg.png" /><figcaption>OpenTelemetry と Cloud Monitoring の活用</figcaption></figure><p>発表資料はこちらになります:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fspeakerdeck.com%2Fplayer%2F1924a7cff9e24a13b3ed4435c81a0ba9&amp;display_name=Speaker+Deck&amp;url=https%3A%2F%2Fspeakerdeck.com%2F110y%2Freliability-at-kauche&amp;image=https%3A%2F%2Ffiles.speakerdeck.com%2Fpresentations%2F1924a7cff9e24a13b3ed4435c81a0ba9%2Fslide_0.jpg%3F25304593&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=speakerdeck" width="710" height="399" frameborder="0" scrolling="no"><a href="https://medium.com/media/192c3e204e83d9035d685363cfa3fb10/href">https://medium.com/media/192c3e204e83d9035d685363cfa3fb10/href</a></iframe><h4>ソウゾウからの事例紹介</h4><p>ソウゾウからは「OpenTelemetry と Datadog の連携」や「gRPC を活用した SLO の定義」について紹介しました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ymtYGazCU6VOpkaRubSz0g.png" /><figcaption>OpenTelemetry と Datadog の連携</figcaption></figure><p>発表資料はこちらになります:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fspeakerdeck.com%2Fplayer%2F315a51cd535f440f8da7151b18328c35&amp;display_name=Speaker+Deck&amp;url=https%3A%2F%2Fspeakerdeck.com%2Fdragon3%2Fobservability-at-souzou&amp;image=https%3A%2F%2Ffiles.speakerdeck.com%2Fpresentations%2F315a51cd535f440f8da7151b18328c35%2Fslide_0.jpg%3F25304399&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=speakerdeck" width="710" height="399" frameborder="0" scrolling="no"><a href="https://medium.com/media/35cbc004a8d818a887aced231e7f677c/href">https://medium.com/media/35cbc004a8d818a887aced231e7f677c/href</a></iframe><h4>パネルディスカッション</h4><p>後半のパネルディスカッションでは、いただいた質問に答えつつ、下記のようなテーマについて議論しました:</p><ul><li>Log の Context の伝搬方法</li><li>Cloud Monitoring と Datadog の対比</li><li>ログのサンプリング</li><li>Monitoring Dashboard の管理方法</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sfY1h8BNkgbPdLS3JTW9Zg.png" /><figcaption>パネルディスカッション</figcaption></figure><h4>おわりに</h4><p>本稿では、「Cloud Run Casual Talk! #2」で解説した内容を簡潔にまとめました。Reliability や Observability とは別のテーマにフォーカスする第 3 回目を開催するかもしれないので、ご期待ください！</p><h4>宣伝</h4><p>カウシェでは、一緒に「世界一楽しいショッピング体験をつくる」メンバーを探しています。興味を持っていただいた場合はぜひ採用情報をご覧いただければと思います:</p><p><a href="https://enjoy-working.kauche.com/">カウシェ採用情報</a></p><p>また、筆者は YOUTRUST でカジュアル面談を公開しています。カウシェに興味を持っていただいている場合はもちろん、「採用に興味はないけど Cloud Run の活用方法を詳しく聞いてみたい！」という場合も歓迎なので、ぜひ応募していただければと思います。</p><p><a href="https://youtrust.jp/recruitment_posts/9c7789aa9a08ab6eb7232e68cf116203">カウシェの Architect と Casual Talk! | YOUTRUST 募集</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4a25199456c" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/cloud-run-casual-talk-2-4a25199456c">Cloud Run Casual Talk! #2 を開催しました！</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Cloud Run Casual Talk! を開催しました！]]></title>
            <link>https://medium.com/kauche/cloud-run-casual-talk-1-7904bdf0baec?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/7904bdf0baec</guid>
            <category><![CDATA[google-cloud-platform]]></category>
            <category><![CDATA[google-cloud-run]]></category>
            <dc:creator><![CDATA[Yuki Ito]]></dc:creator>
            <pubDate>Fri, 24 Feb 2023 03:23:04 GMT</pubDate>
            <atom:updated>2023-02-24T05:03:24.654Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*19Mbo8YkCTxgPZE0ddXbGg.png" /><figcaption>Cloud Run Casual Talk! ~ #1 カウシェ・ソウゾウ の CI/CD + QA 環境にDeep Dive! ~</figcaption></figure><p>こんにちは、株式会社カウシェの Architect の伊藤です。</p><p>本稿では、先日開催した「Cloud Run Casual Talk! 〜 #1 カウシェ・ソウゾウ の CI/CD + QA 環境にDeep Dive！〜」というテックイベントについて内容を簡潔にまとめます。動画のアーカイブが YouTube 上で閲覧できるので、そちらも合わせてぜひご覧ください！</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FLrX3kQ-8_0Q%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DLrX3kQ-8_0Q&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FLrX3kQ-8_0Q%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/62202053af58e894f59ae95efe6feaa4/href">https://medium.com/media/62202053af58e894f59ae95efe6feaa4/href</a></iframe><h4>Cloud Run Casual Talk! とは</h4><p>「Cloud Run Casual Talk!」は、<a href="https://cloud.google.com/">Google Cloud</a> が提供しているマネージドなコンテナ実行環境である <a href="https://cloud.google.com/run">Cloud Run</a> を利用している企業のエンジニアが事例を解説し、パネルディスカッションでさらに深堀りしていくイベントです。今回は、発起人であるカウシェ所属の筆者と、Cloud Run をヘビーに活用されているソウゾウ所属の <a href="https://twitter.com/dragon3">dragon3 さん</a>から、Cloud Run の活用事例について、特に CI/CD や QA 環境の構築にフォーカスして解説しました。</p><h4>カウシェからの事例紹介</h4><p>カウシェからは「Cloud Build を用いた CD」や「自作している xDS Control Plane を用いた QA 環境の構築」について紹介しました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-7J33qCS3o5ctfPNhIJs9g.png" /><figcaption>xDS Control Plane を用いた Cloud Run の QA 環境の構築</figcaption></figure><p>発表資料はこちらになります:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fspeakerdeck.com%2Fplayer%2F3fbc8768f8d24327a277709225801f6e&amp;display_name=Speaker+Deck&amp;url=https%3A%2F%2Fspeakerdeck.com%2F110y%2F2023-0215-cloud-run-casual-talk&amp;image=https%3A%2F%2Ffiles.speakerdeck.com%2Fpresentations%2F3fbc8768f8d24327a277709225801f6e%2Fslide_0.jpg%3F24451007&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=speakerdeck" width="710" height="399" frameborder="0" scrolling="no"><a href="https://medium.com/media/6d2412504fbf9bbbb04bdc5d28e5a585/href">https://medium.com/media/6d2412504fbf9bbbb04bdc5d28e5a585/href</a></iframe><h4>ソウゾウからの事例紹介</h4><p>ソウゾウからは「Cloud Monitoring と連動した Canary Rollout」や「Cloud Run の Revision を活用した QA 環境の構築」について紹介しました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mxErxCYv9t2Voa5_JI55GQ.png" /><figcaption>Cloud Monitoring と連動した Canary Rollout</figcaption></figure><p>発表資料はこちらになります:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fspeakerdeck.com%2Fplayer%2F9c5f759a92784f339a0380e4db1e548d&amp;display_name=Speaker+Deck&amp;url=https%3A%2F%2Fspeakerdeck.com%2Fdragon3%2Fcd-plus-qa-at-souzou-cloud-run-cassual-talk&amp;image=https%3A%2F%2Ffiles.speakerdeck.com%2Fpresentations%2F9c5f759a92784f339a0380e4db1e548d%2Fslide_0.jpg%3F24525279&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=speakerdeck" width="710" height="399" frameborder="0" scrolling="no"><a href="https://medium.com/media/003562f9b1b919591bc750404c8f35c1/href">https://medium.com/media/003562f9b1b919591bc750404c8f35c1/href</a></iframe><h4>パネルディスカッション</h4><p>後半のパネルディスカッションでは、いただいた質問に答えつつ、下記のようなテーマについて議論しました:</p><ul><li><a href="https://cloud.google.com/kubernetes-engine">Google Kubernetes Engine</a> と比較して Cloud Run を採用している理由</li><li>データベースのマイグレーション</li><li><a href="https://cloud.google.com/deploy">Google Cloud Deploy</a> についての所感</li><li>マニフェストを用いた宣言的なデプロイ</li><li>QA 環境の構築について、Cloud Run の Service ベース（カウシェ）と Revision ベース（ソウゾウ）の仕組みの対比</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bLnis8DFBLPSULfIxqYY9A.png" /><figcaption>パネルディスカッション</figcaption></figure><h4>おわりに</h4><p>本稿では、「Cloud Run Casual Talk!」で解説した内容を簡潔にまとめました。CI/CD や QA とは別のテーマにフォーカスする第 2 回目 も開催予定なので、ぜひご期待ください！</p><h4>宣伝</h4><p>カウシェでは、「世界一楽しいショッピング体験をつくる」ための Site Reliability Engineering を先導してくださるエンジニアを探しています。本稿で紹介したような Cloud Run を始めとする Google Cloud のサービスの活用方法を含めて、常に「より良いアーキテクチャ」を模索しているエキサイティングな環境なので、興味を持っていただいた場合はぜひ採用情報をご覧いただければと思います:</p><ul><li><a href="https://hrmos.co/pages/kauche/jobs/0100078">【Software Engineer (Site Reliability Engineering)】シェア買いアプリ「カウシェ」のSoftware Engineerを募集します！ | 株式会社カウシェ</a></li><li><a href="https://enjoy-working.kauche.com/">カウシェ採用情報</a></li></ul><p>ソウゾウでも Site Reliability に携わるエンジニアを募集されているようなので、こちらもぜひご覧いただければと思います:</p><p><a href="https://apply.workable.com/mercari/j/34C87986DC/">Software Engineer, Site Reliability / ソフトウェアエンジニア (Site Reliability) - Souzoh - Mercari, inc.</a></p><p>また、筆者は YOUTRUST でカジュアル面談を公開しています。カウシェに興味を持っていただいている場合はもちろん、「採用に興味はないけど Cloud Run の活用方法を詳しく聞いてみたい！」という場合も歓迎なので、ぜひ応募していただければと思います。</p><p><a href="https://youtrust.jp/recruitment_posts/9c7789aa9a08ab6eb7232e68cf116203">カウシェの Architect と Casual Talk! | YOUTRUST 募集</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7904bdf0baec" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/cloud-run-casual-talk-1-7904bdf0baec">Cloud Run Casual Talk! を開催しました！</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Fivetran をつかった Shopify → BQ 連携と注意点]]></title>
            <link>https://medium.com/kauche/fivetran-shopify-bq-sync-4c983217cfb5?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/4c983217cfb5</guid>
            <category><![CDATA[data-engineering]]></category>
            <category><![CDATA[bigquery]]></category>
            <category><![CDATA[shopify]]></category>
            <category><![CDATA[fivetran]]></category>
            <dc:creator><![CDATA[Tatsuya  Shirakawa]]></dc:creator>
            <pubDate>Wed, 11 Jan 2023 07:55:40 GMT</pubDate>
            <atom:updated>2023-01-11T09:45:47.405Z</atom:updated>
            <content:encoded><![CDATA[<p>こんにちは！カウシェで ML Engineer をしている<a href="https://note.com/tatsuyashirakawa/n/n6fea7582d848">白川 達也（tatsuya）</a>です。</p><p>機械学習をするために商品データを取得しようとしたら Shopify → スプシ → BigQuery という構成で商品情報が参照されており、この連携部分がとても不安定だったので、Fivetran を導入して安定化させてみました。その中で、Fivetran をつかった連携において注意したほうがいい点なども見えてきたので、共有できればと思います。</p><p>Fivetran、すばらしいサービスですね！一気にファンになりました。</p><h3>Fivetran 導入以前の Shopify → BigQuery 連携</h3><p>カウシェでは商品の管理に Shopify を用いています。データ分析などは基本的にすべて BigQuery 上で行われており、Shopify 上に蓄積されているデータも BigQuery へ連携されています。この連携ですが、下記のような構成で行われていました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1FPxh6OFv2jitetA1HsXCg.png" /><figcaption>これまでの連携方法</figcaption></figure><p>しかし、カウシェに出品される商品点数が増加するに従い、この構成だと、</p><ul><li>Shopify からスプシへ GAS でデータ取得している部分でしばしばデータ取得に失敗する</li><li>BigQuery からスプシを参照する部分が非常に低速</li></ul><p>という問題が発生し、商品データを用いてデータ分析や機械学習をする上での障害となっていました。</p><h3>Fivetranの導入</h3><p>そこで <a href="https://www.fivetran.com/">Fivetran</a> を導入し、Shopify → BigQuery のデータ連携を安定化させることにしました。</p><p>Fivetran は外部データソースごとに定義された Connector を用いて目的の Data Warehouse、DB など（Destination）へデータを Extract &amp; Load するためのサービスです。Connector、Destination ともにあらかたのサービス・DB などは揃っていそうです。</p><p>今回 Fivetran を用いて Shopify → BigQuery への連携をする際には、下記の記事を大いに参考にしました。基本的にはボタンをポチポチしながら必要なフォームを埋めていく感じなので、慣れれば本当に簡単に連携ができます。</p><p><a href="https://dev.classmethod.jp/articles/fivetran-looker-shopify/">FivetranとLookerを使ってShopifyのデータ分析環境をマッハで用意する | DevelopersIO</a></p><p>Fivetran を用いた Shopify → BigQuery 連携は大雑把には下記のような手順になります。</p><ol><li>Destination として BigQuery を指定。この際、Fivetran にサービスアカウント（Fivetran 側で自動で生成してくれます）などを通じて BigQuery への書き込み権限を付与する必要があります。</li><li>Connector として Shopify を指定。この際、Shopify へのアクセス権限が必要なため、Shopify 上で十分な権限（後述します）をもった Private App を作成し、その App のAPI access token を取得しておく必要があります。</li><li>連携するデータを指定する際には、後から schema を変更し、連携するデータを選びます。同じく連携する間隔（プランによって選べるものが異なりますが 5 分、1 時間など）も設定します。</li></ol><p>Shopify、BigQuery、Fivetran と 3 つのサービスをまたぐので、権限管理が分散しているとちょっと面倒かもしれません。</p><p>いずれも上で紹介した記事に具体的な方法が書いてあるので、詳細はそちらに譲るとして、この記事では実際に Fivetran で Shopify → BigQuery 連携をするにあたって躓いたポイントや留意点を中心に紹介したいと思います。</p><p>いまのところ、Fivetran で連携することにして大正解でした。安定性・スケーラビリティなど何も気にすることなく、自分たちで連携を構築・運用するよりずっと手軽かつ安価に運用できています。</p><h3>どのプランにすべきか</h3><p>本記事執筆時点では現状 4 種のプランがあります。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*s616phRd_z-ENsshjoGOJw.png" /><figcaption>Fivetran の pricing (<a href="https://www.fivetran.com/pricing">https://www.fivetran.com/pricing</a>)</figcaption></figure><p>Fivetran の使用料金は、MAR（Monthly Active Rows）という月あたりに追加・更新・削除されたデータレコード数（Destination 側での累計データ更新行数です）に応じた月額の従量課金制になっています。使えば使うほど、MARあたりの単価が安くなる設計になっており、MAR がわかれば料金が決まるという仕組みです。本記事執筆時点では 1 M MAR（1 ヶ月あたり 100 万行のデータ追加・更新・削除）あたり $500 という設定でした。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uIALaMftXkd0wfVbAQV7rg.png" /><figcaption>MARあたりの単価 (<a href="https://www.fivetran.com/pricing">https://www.fivetran.com/pricing</a>)</figcaption></figure><p>そのため料金を見積もるために知らねばならないのは、データ連携するとどれくらいの MAR になるかなのですが、MAR の見積もりは連携開始から 1 週間たたないと計算されない仕組みになっており、14 日間の trial 中に早々に連携しておかないと期間中に MAR がわからないという事態になります（trial が終了してからもダッシュボード上で確認はできそうですが）。自分の場合、年末年始を挟んで連携などしていたのでちょっと困りました。</p><p>なお、使用料金が MAR に比例するため、更新頻度が高いデータを連携しようとすると必然的に課金額が増えていきます。そのためカウシェでも、更新頻度が激しすぎないデータを中心に連携をすることで様子を見ながら small start させています。E−commerce なのもあって年末年始は特別なシーズンではあるのですが、今のところいい感じです。連携するデータはあとから自由に再設定できます。</p><h3>Google Marketplaceでの課金</h3><p>カウシェでは各種サービスの課金を Google Marketplace へなるべく統合しています。Fivetran も Google Marketplace に対応しているので、必要であればそちらで課金をしたほうが良いでしょう。</p><p>Fivetran ではなく Fivetran Data Pipelines という名前になっていたので、一瞬これでいいのかと思ってしまいましたが、これで良いようです。</p><p><a href="https://console.cloud.google.com/marketplace/product/fivetran/fivetran-marketplace?hl=ja&amp;project=kauche-analytics-prod">Google Cloud console</a></p><h3>Terraform を使った構成管理もできるらしいが…？</h3><p>Fivetran には Terraform の<a href="https://registry.terraform.io/providers/fivetran/fivetran/latest/docs">公式 Provider</a> があり、Terraform での構成管理もできるようです。カウシェも基本的には可能な限りすべてのサービスを Terraform で管理しているため、当初はTerraform を使って構成管理をしようと考えたのですが、以下の観点からひとまずは Web 上での設定からスタートすることにしました（あとから移行できるようにすべてのステップでスクリーンショットをとり、トレースできるようにはしてあります）。</p><ul><li>公式 Provider は、どうやら REST API の仕様と Terrafrom での記述を対応させて作っているようで、Providerのドキュメントの先頭の部分にREST API を見るようにとの記載があります。ただ、Terraform での構成管理を実際に行ったブログ記事などもすぐには見つからず、REST API の記述を Terraform の設定としてどう転記すればいいのかを含めてトライアル期間中にちゃんと調査・検証しきるのは大変そうでした。</li><li>Terraform で構成管理をしようとすると、REST API が使える Standard 以上のプランにする必要があり、MAR あたりの料金が 1.5 倍ほどになります。Terraform での管理のために 1.5 倍の料金を払うのは気が引けました（こちらのほうがメイン）。</li></ul><p>いずれは Terraform 管理に移行したいので、もし Terraform での管理に成功されている方がいれば、ぜひ記事を書いていただけると嬉しいです！</p><h3>データ連携先の BigQuery データセット名を指定したい</h3><p>Connectorを設定する際に、Destination schema という項目があるのですが、これが Big Query のデータセット名に対応するようです。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gPRmfVSitaq5_mDO8G27LQ.png" /><figcaption>Destination schema が BigQuery のデータセット名になる</figcaption></figure><h3>どのデータを連携するか</h3><p>Fivetran ではどのデータを連携するかを指定できます。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WOod7puTWubp047ybGCkjw.png" /><figcaption>連携するデータをチェックする</figcaption></figure><p>ただし、注意点として、同時に連携させねばならないデータのセットが存在します。そのようなデータは一括で指定をする必要があります（図中の product 〜 product_variant などがそれです）。</p><p>前述の MAR も連携元ではなく実はこの連携先のデータに対してカウントされるので、単一のデータでも分割されるとそれに応じて料金は膨らむことがありえます。なので、実際にどれくらいのボリュームになるかはデータ単位で事前に見積もっておいたほうが良さそうです。</p><p>また、先述の通り、更新頻度が高いデータを連携すると MAR が膨らみやすいので、small start するのであればその点も注意が必要です。</p><p>なお、ここでのデータ連携先の指定は、Shopify Private App に対して許可するデータアクセスのパーミッションと連動しているようです。ドキュメントには見つからなかったのですが、例えば商品データ（product 〜 product_variant）のみを指定して連携するのであれば、Private App に付与するアクセスパーミッションは read_products だけで良いようです。その他のパーミッションは下記をご覧ください（ただし、ドキュメントには必要なパーミッションのみ付与すれば OK とは書いていませんでした）。</p><p><a href="https://fivetran.com/docs/applications/shopify#shopifyapiaccessscopes">Fivetran</a></p><h3>おわりに</h3><p>注意点を中心にご紹介してしまったので Fivetran は難しいサービスなのではと思わせてしまったかも知れませんが、自分が試した限りでは上記の項目くらいだけ注意しておけばあとは本当に簡単に連携ができました。従量課金制で small start もしやすいのでおすすめです。</p><p>最後に宣伝です。カウシェでは、データの連携や管理、活用などを担っていただける Data Engineer の他、データサイエンティストや機械学習エンジニアを募集しています。新しい技術を使いながら EC 業界に新しい体験を作っていくことにご興味を持っていただけた方はぜひお話させてください。ご感想含め、Twitter <a href="https://twitter.com/s_tat1204">@s_tat1204</a> や <a href="https://youtrust.jp/users/tatsuyashirakawa">YouTrust</a> などでのお声がけもお待ちしています。</p><p><a href="https://enjoy-working.kauche.com/">カウシェ採用情報</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4c983217cfb5" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/fivetran-shopify-bq-sync-4c983217cfb5">Fivetran をつかった Shopify → BQ 連携と注意点</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[ほぼ複業メンバーのチームで、1年以上開発を続けて学んだこと]]></title>
            <link>https://medium.com/kauche/2022-partner-team-262ac66d06a1?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/262ac66d06a1</guid>
            <category><![CDATA[management]]></category>
            <category><![CDATA[team-collaboration]]></category>
            <category><![CDATA[team]]></category>
            <category><![CDATA[team-management]]></category>
            <category><![CDATA[team-building]]></category>
            <dc:creator><![CDATA[Kyohei Ikematsu]]></dc:creator>
            <pubDate>Wed, 21 Dec 2022 12:54:46 GMT</pubDate>
            <atom:updated>2022-12-21T13:09:28.627Z</atom:updated>
            <content:encoded><![CDATA[<h3>ほぼ複業メンバーのチーム体制で、1年以上開発を続けて学んだこと</h3><p>こんにちは。カウシェでエンジニアリングマネージャーをしている<a href="https://twitter.com/ike002jp">ike</a>です。</p><p>僕は<strong>事業者向け管理ツール（以下、パートナー管理画面）</strong>の開発チームにいます。カウシェに商品を出品してくださる事業者の方が利用するプロダクトです。</p><p>チームには9名いて、<strong>僕とデザイナーのkikku-san以外は複業メンバー</strong>です。カウシェは全社的に複業メンバーが多いですが、その中でもかなり複業比率の高いチームだと思っています。</p><p>1年以上この体制で開発を継続しています。振り返ると「スムーズに開発を進めるする上で重要だったな」という点や「いくら頑張ってもこの体制ではできないこともあるな」などがあります。</p><p>今回はこのチームでの開発で学んだことを、<a href="https://adventar.org/calendars/7660">シェア買いアプリ「カウシェ」 Advent Calendar 2022</a>の21日目の記事として書こうと思います。</p><p>↓こんなことを書いていきます。</p><ul><li>チーム構成</li><li>約14ヶ月で開発した機能</li><li>新規複業メンバーの立ち上げで大切なこと</li><li>最初にどんな仕事をお願いすると良いか</li><li>お願いを控えたほうがよい仕事</li><li>心構えとして重要なこと</li><li>困難なこと</li></ul><h3>チーム構成</h3><p>この1年で多少変化はあったものの、おおよそ以下の構成でした。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/436/0*xxYtcFQSr4tZmdR3.png" /></figure><p>僕たちのチームの複業メンバーはどなたも本業をお持ちです。カウシェでの月の稼働時間は30〜40時間です。平日夜に稼働する方、週末に稼働する方など様々です。</p><p>そういえば：最初は現CPOのakky-sanがPMで、デザイナーは全員複業でした。その状態から徐々に変化して上記になり…もうすぐ新たな仲間としてPM、バックエンドエンジニア、QAのフルタイムメンバーが加入予定です。それによって僕のロール兼任状態を改善できそうで楽しみです。</p><h3>約14ヶ月で開発した機能</h3><p>パートナー管理画面はゼロイチの開発でした。この1年は以下のようなEC管理画面に必須な機能の開発が中心でした。</p><ul><li>認証（ログイン、ログアウト、アカウント一覧）</li><li>ストア管理（送料、ストア情報設定）</li><li>商品管理（商品登録・編集、一括操作周り）</li><li>注文管理（シェア買い成功した購入の一覧、変更、一括操作周り）</li><li>内部オペレーションで必要な機能</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/700/0*6fAieXmxRxrckRUK.png" /><figcaption>初期リリース時のパートナー管理画面</figcaption></figure><h3>新規複業メンバーの立ち上げで大切なこと</h3><p>オンボーディングのドキュメントを作っておき、最初に必要な作業（各種アカウントの登録など）や必要な情報（仕様やアーキテクチャ図など）へのアクセスを整えておきつつ、以下を行うのが良いと思っています。</p><h4>1回目の1on1を30分、早いタイミングで行う</h4><ul><li>お互いの自己紹介を話す、カウシェでやれたら嬉しいこと・あまりやりたくないことなどを聞く（ 今まで経験したことのない業務ロジックの実装に関わりたい、など、人によっては求めているものがあったりする）</li><li>「どこまで口を挟んでよいのだろう」など、複業側としてなんとなく不安な部分が序盤はある</li><li>安心感を持っていただく、お互いを知る、今後どのようなことをおまかせするのが良いか肌感を掴むために行う</li></ul><h4>最初の1ヶ月は毎週30分くらい、1on1を行う</h4><ul><li>実装過程での不明点、ちょっとした困りごとが序盤は特にある</li><li>だが、慣れるまではフルタイムメンバーに聞くのを遠慮しがち</li><li>フルタイムメンバーの時間をとるの申し訳ないと思っているケースもある</li><li>slackで聞くほどではないけどこの場があるなら聞いてみるか、のノリで会話が始まり、有益な情報を伝えることができるシーンが序盤は多い</li><li>なので最初は少し頻度多くても、費用対効果が高い感覚</li><li>解決を早期に行えるし、ここまで聞いて良いんだ、こう進めれば良いんだ、という状態を早めに作りやすい</li><li>2ヶ月目以降は頻度を減らす</li><li>ただし数ヶ月に1回程度は1on1を続ける</li></ul><h4>チーム内外の人との1on1(1onN)の時間を、最初の方に作る</h4><ul><li>業務上近づく可能性がある人を中心に10名前後</li><li>定性感覚だが、やるかやらないかで馴染みやすさが変わると思う</li><li>ちなみにカウシェではパートナー管理画面チームだけではなく、welcome 1on1という名目で全社的にこれは行われている</li></ul><p><strong>作業者として迎え入れるのではなく、チームの一員として迎え入れる</strong>という姿勢が重要と思います。このあたりを何もやらないと、加入者側はなんとなく一歩引いた状態が継続してしまいやすいと思います。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/700/0*3sbNEmyhVgC_mlP3.jpeg" /><figcaption>週次でやっているチーム定例の開始待ち</figcaption></figure><h3>最初にどんな仕事をお願いすると良いか</h3><p><strong>小さくてかつチーム貢献感のある仕事</strong>、が良いと思います。</p><ul><li>1–2ヶ月かかりそうな大きめものとかは避ける</li><li>要件や仕様がふわふわしているものは避ける（これは常に避ける）</li><li>複業の時間の範囲で、1–2週間でできるものが良い</li><li>既存機能の小改善、開発体験悪い部分の改善など</li><li>優先度の高いものでなくても良い</li><li>小さいものであることがより重要</li></ul><p>最初の1つ2つの仕事で<strong>小さな成功体験を積んでいただく</strong>のが重要、というイメージです。なので<strong>優先度が高いことよりもサイズが小さいことのほうが大事</strong>かな、と思います。</p><p>小さい仕事を進めていくうちにキャッチアップもできるし、何より、アウトプットを少しでも残せると焦りも減ります（任せる側の焦りも加入者側の焦りも）。</p><h3>お願いを控えたほうがよい仕事</h3><p>どんな仕事をお願いするか、控えるかは、フルタイムにどんな能力を持つ人がいて、複業にどんな能力を持つ人がいるか、によって少し変わるかなとも思います。</p><p>今の僕たちのチーム構成だと以下かな、と考えています。</p><h4>期日が近いもの、または期日調整をし難いものは控える</h4><ul><li>複業の方には本業があり、時間を使えるタイミング・使えないタイミングが日ごとや週ごとで異なる</li><li>なので緊急度の高い仕事は相性が悪い</li><li>重要だが期日に余裕のあるもの、または期日を調整可能なものをお願いする</li></ul><h4>対複業エンジニアに、要件定義や仕様調整をお願いするのは控える</h4><ul><li>能力的に要件定義などができる方であっても控える</li><li>How（設計や実装）に集中してもらったほうが全体生産性が高い</li></ul><h4>対複業PMに、抽象度が高すぎる課題をお願いするのは控える</h4><ul><li>長期ロードマップ、戦略検討の丸投げなど</li><li>そのようなものは社内の広範囲な情報が必要になる</li><li>多くの人やチームから情報を得る必要がある</li><li>社内の状況変化が早いので、常にキャッチアップが必要になる</li><li>月30–40時間と限られた中でやるのは、おそらく誰であっても不可能</li><li>特定機能の要件定義や数値分析、UXリサーチなど、スコープをある程度は限定したものをお願いしたほうが良い</li></ul><p>基本的な考えとして<strong>ブロッカー要素が少ない状態、なるべく複業メンバーが独立して進められる状態を事前に作れるか</strong>、が大事だと思っています。</p><p>時間は限られているが優秀な人達が複業で協力してくださるという状況において、フルタイムメンバーが一定の時間を準備のために使って動きやすい状態を作ったほうが、全体として生産性が高くなる感覚です（準備＝要件定義をしっかりやってから開発を開始する、などを含む）。</p><p>複業メンバーの時間が潤沢なら話は変わると思います。</p><h3>心構えとして重要なこと</h3><p>個人的に思っていることです。僕の性格だと以下のように考えた方がうまくいく、という感じです。</p><h4>頼るし遠慮をしない</h4><ul><li>複業だからこのくらいまでにしとこうかな、と、勝手に思わない</li><li>大きかったり難しそうなことも、相談してみる</li><li>副業ではなく複業である、と考える（カウシェは相手にとって2つ目の本業である、という考え）</li><li>公開する情報にもフルタイムと差を設けない、とりあえず伝える</li></ul><h4>とはいえ本業があるがゆえの制約を頭に入れる</h4><ul><li>認知できる情報量にそもそも限度がある（どんなに長くカウシェ複業に関わっていても、キャッチアップできない部分がでてくる）</li><li>相手の忙しさ等をふまえて、こちら側で調整の努力を行う</li></ul><h3>困難なこと</h3><h4>スケジュール通りに進めるのが通常より難しい</h4><ul><li>複業の方には本業がある</li><li>本業の忙しさによってカウシェに割ける時間は変動するが、その忙しさはこちらでコントロールできない</li><li>本業の忙しさを聞いた上でスケジュールを立てる、スコープに削れるものを用意しておく、などが回避策だが、通常より難易度が高い</li></ul><h4>開発からリリースまでのサイクルを早めるのが難しい</h4><ul><li>フルタイム主体の場合と比べると1機能を開発するための期間が絶対に長くなる</li><li>複業メンバーを増やしたとしても早めるのは困難（タスクを分割して分担実施する場合、相互コミュニケーションがおそらくネックになる。分割しないで進める場合、フルタイムと比べると期間が必要になる）</li><li>開発終了⇒QA⇒改修確認などのように開発は進むと思うが、エンジニアもQAも両方複業だと、お互いの待ち時間により、期間が長くるリスクが高くなる（フルタイム同士の場合と比べると特に）</li></ul><h4>その他</h4><p>「複業主体だとマネジメントなどのコストが高くなって大変なのでは？」という質問をいただくことがあります。</p><p>高くなる部分はあると思います。例えば以下です。</p><ul><li>緊急度の高いものは控えたいため、アサインの考慮が通常より必要</li><li>スケジュール通り進まないリスクが高いため、調整コストが発生しやすい</li></ul><p>一方で「要件定義や仕様策定などの準備をしっかり行う」などはフルタイム主体の場合とチームトータルでは変わらないのではと思っています。</p><p>複業主体の方が準備に手を抜いたときの跳ね返りが強い印象があり、ゆえに準備の負担がフルタイムに寄りやすい気はしています。ただし複業主体だろうとフルタイム主体だろうと、どっちみち誰かが負担していたコストが寄っているだけで、チームトータルで見ると実はそんなに変わらないのでは、と思っています。</p><h3>まとめ</h3><p>複業主体のチーム運営について書いてみましたが、いかがでしたでしょうか？書いてて思いましたが、複業・フルタイムに限らず普通に重要そうなことも多そうですねー…。</p><p>どなたかの参考になれば嬉しいです！</p><p>最後になりますがカウシェではバックエンドエンジニア、SREなど多くのポジションを募集しています。カジュアル面談で色々お話できることも多いので、興味のある方はぜひ以下も見ていただけると！</p><ul><li><a href="https://enjoy-working.kauche.com/product">https://enjoy-working.kauche.com/product</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=262ac66d06a1" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/2022-partner-team-262ac66d06a1">ほぼ複業メンバーのチームで、1年以上開発を続けて学んだこと</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[カウシェプロダクト2022年の振り返り]]></title>
            <link>https://medium.com/kauche/kauche-product-2022-ba6af48c3f8a?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/ba6af48c3f8a</guid>
            <dc:creator><![CDATA[Akifumi Fukaya]]></dc:creator>
            <pubDate>Mon, 19 Dec 2022 23:03:56 GMT</pubDate>
            <atom:updated>2022-12-26T01:29:24.769Z</atom:updated>
            <content:encoded><![CDATA[<p>こんにちは！カウシェ取締役CPOの <a href="https://twitter.com/akifumifukaya">@akifumi</a> です。<br><a href="https://adventar.org/calendars/7660">シェア買いアプリ「カウシェ」 Advent Calendar 2022</a> 20日目を担当させていただきます。</p><p>2022年1月にCPOに就任し、ちょうど1年が経ちます。<br>この1年間を振り返りつつ、2022年に実施したプロダクトリリースとプロダクト開発組織について、記載させていただきます。</p><h3>カウシェプロダクト1年の振り返り</h3><p>2022年に実施したプロダクトリリースとプロダクト開発組織について、時系列で振り返っていきたいと思います。<br>後付ではあるのですが、そのときのキャッチコピーも添えてみます。</p><h4>1月: パートナー向け管理画面リリース</h4><p>2021年10月から 事業者向けの管理ツール（以下、パートナー管理画面） の開発を進めていました。<br>そして、3ヶ月後の2022年1月にCSVによる商品一括アップロードのみ可能なMVPを、年始にリリースしました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tT6V5RbYF5VJq3NYQmbRyg.png" /><figcaption>パートナー管理画面</figcaption></figure><p>カウシェアプリでは、1月から家電の取り扱いを開始しました。<br>合わせて、下タブを導入し、情報の整理とアクセシビリティの強化を行いました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*F1ikVkyCtlp26hdYIuAIQQ.png" /></figure><h4>2月: 大人数シェア買い開始！様々なバリエーションを実現可能に</h4><p>大人数シェア買いを開始。シェア買い人数や制限時間を変更することができ、より多くのバリエーションでシェア買いを行うことができるようになりました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/370/1*ebufanSxOidUrGcMmlLN5g.png" /><figcaption>大人数シェア買い</figcaption></figure><p>パートナー管理画面は v1.1.0 として、商品単品登録 / 商品編集 / 送料設定の登録・編集 / 特商法の登録・編集 ができる機能をリリースし、パートナーが自立して管理画面を使用できる状態になりました。</p><h4>3月: ソーシャル体験の第一歩</h4><p>2022年から、よりソーシャル体験の開発に力を入れ始めました。<br>その第一歩として、プロフィール機能の開発とリリースを行いました。<br>カウシェの中にアカウントを持ち、ソーシャル体験の土台作りを行いました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dRJAQq1BxGzcdkc6YbGzqQ.png" /></figure><p>この頃の Product 組織は、正社員: 5名 / 複業: 12名 で Customer Team / Partner Team 体制でした。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sRYzys1b02TNhSNDZyZzwQ.png" /></figure><h4>4月: お気に入り登録ができるように</h4><p>お気に入り機能のリリース。リピート購入やシェア買い開始により気が付きやすい機能を追加しました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-ht5kY8-OMAxHnjl_AnrFA.png" /></figure><p>パートナー管理画面では、パートナーの移行対応を開始。<br>カウシェに出店してくれている全パートナーの移行を順次開始していきました。</p><h4>5月: ミッションにより、ゲーム性をUP</h4><p>ミッション機能をリリース。<br>特定の条件をクリアすることで、リワードを達成することができます。この機能により、シェア買いによりゲーム性を追加しました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FABxSvIoDcZoECqQsFgsDA.png" /></figure><h4>6月: 初の超シェア買い祭を開催</h4><p>カウシェ初となる、超シェア買い祭を開催しました。定期的にお得なセールやイベントを開催し、盛り上がりを作っています。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2GRNsn1xOyCSLzq1NLK14w.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*r6WE_-Gxmlrcbkwg_kXpuQ.jpeg" /><figcaption>初の超シェア買い祭</figcaption></figure><p>この頃の組織は、以下のような体制で、7月には正社員が2名参画することが見えていました。<br>そのため、足りていないポジションがありながら、よりスケールした開発体制を目指し、 Try First に Customer Team を分割することを決めました。<br>しかし、これは後に失敗となります。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4tYJqZMejYj5M49H8XYl2A.png" /></figure><h4>7月: チーム分割</h4><p>7月、ソーシャル体験の開発に注力するため、Customer Team を Commerce UX / Social UX に分けることに。<br>Commerce UX / Social UX / Partner / Platform の4チーム体制。<br>合わせて、マネジメントラインと開発チームを分け、マトリックス組織に変更しました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*C62LuZQhM2LsA7Td-bIaew.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*guy99HZUpCeH0_rqoDPSjg.png" /></figure><p>コスメリリースに合わせ、ホームの商品一覧画面に上タブカテゴリを追加しました。</p><h4>8月: 開発効率の悪さを課題に</h4><p>より商品を探しやすくするために、商品検索にフィルター機能を搭載しました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7EXKcLm0GKKC1dvMrI0eEA.png" /></figure><p>しかし、Product開発組織ではチーム分割を早めたことにより、開発効率の悪化や兼務の増加が問題となりはじめました。</p><h4>9月: チーム分割失敗</h4><p>兼務の方のスクラムイベントの増加 や 開発効率の悪さ の問題が現場から上がるようになりました。<br>結果として、チーム分割に失敗を判断。<br>10月から、分割したチームを再度1つの Customer Team に統合することを決意しました。</p><p>失敗要因は、以下のようなものが上げられます。</p><ul><li>チーム分割が早かったことにより、PM / Designer の方が兼務せざる負えない状況</li><li>その結果、スクラムイベントが増えるなど業務負荷が高まり、非効率な状態に</li><li>エンジニアが分散したことで、Backend / iOS / Android のアウトプットバランスが悪く、開発効率が悪化</li></ul><p>その際、Product Manager と Backend Tech Lead 採用を最重要事項とし、再チーム分割の基準にしました。</p><h4>10月: 累計100DL突破</h4><p>累計ダウンロード数が100万件を突破しました。<br><a href="https://prtimes.jp/main/html/rd/p/000000036.000064598.html">https://prtimes.jp/main/html/rd/p/000000036.000064598.html</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bEn1cWU7uW3bRzg-6Qo0PQ.png" /></figure><p>リリース初期の頃に掲げていたロードマップのひとつを達成しました！<br>さらなる上を目指して、引き続き尽力いたします。</p><p>また、よりお客様が繋がりながらお買い物をする体験を実現するべく、フォロー機能をリリースしました。</p><p>フォローユーザーのシェア買い募集が見れる機能も開発しています。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MkvdtA7i5W0Wuakurt0S5g.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UDnkpvLtYmRQ_FmGB4H38g.png" /></figure><h4>11月: HOTなシェア買いにより、偶然な出会いを創出</h4><p>「HOTなシェア買い」という機能をリリースしました🔥<br>カウシェ内の人気なシェア買いをフィーチャーしています。<br>この機能により、従来の検索型の体験ではなく、商品やグループとの偶然の出会いを生み出しています。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BG2Vj1j7uArIq9PHa9PmEg.jpeg" /></figure><h4>12月: よりインタラクティブなショッピング体験へ</h4><p>お客様がコミュニケーションしながらお買い物をする体験を実現するべく、グループスタンプ機能の提供を開始。<br>シェア買いの中でお客様同士がインタラクティブにやりとりできるようになりました。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4CWCyT8-7XeikuQF7hnRsw.png" /></figure><p>また、新規のお客様とシェア買いする機能「ご新規さんとシェア買い機能」をリリースしました。<br>ご新規さんと一緒にお買い物することで、とてもお得にシェア買いできます！<br>この機会に是非、利用していただけると嬉しいです。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4Taf7EACV1-w3OV8s3i9rQ.jpeg" /></figure><h3>2023年について</h3><p>来年は、以下の三本柱に注力していきたいと考えています。</p><ul><li>ソーシャル体験の強化</li><li>より興味関心のある商品との出会い</li><li>お得の仕組みづくり</li></ul><p>プロダクト開発組織では、正社員・複業合わせて約40名の規模になってきました。<br>チームがより自律・自燃に開発でき、プロダクト価値提供できる体制をつくっていきたいと思っています。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ehGzb52Uwc8w2ZaAkxQGWg.png" /></figure><h3>最後に</h3><p>カウシェでは共に事業価値を作り、「世界一楽しいショッピング体験をつくる」というビジョンの実現に挑戦していただける方を募集しています！とりあえず話してみたいでも構いませんので、ぜひご気軽に連絡いただけますと幸いです。</p><p><a href="https://enjoy-working.kauche.com/">カウシェ採用情報</a></p><p>明日の <a href="https://adventar.org/calendars/7660">シェア買いアプリ「カウシェ」 Advent Calendar</a> 執筆担当者は、 @ike さんです。引き続き、お楽しみください。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ba6af48c3f8a" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/kauche-product-2022-ba6af48c3f8a">カウシェプロダクト2022年の振り返り</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[CUE を利用した Envoy の設定ファイルの管理]]></title>
            <link>https://medium.com/kauche/managing-envoy-configurations-by-cue-f55a597bfaf6?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/f55a597bfaf6</guid>
            <category><![CDATA[envoy-proxy]]></category>
            <dc:creator><![CDATA[Yuki Ito]]></dc:creator>
            <pubDate>Mon, 19 Dec 2022 07:03:59 GMT</pubDate>
            <atom:updated>2022-12-19T07:04:02.564Z</atom:updated>
            <content:encoded><![CDATA[<p>こんにちは、株式会社カウシェの Architect の伊藤です。</p><p>本稿では、カウシェで実践している「CUE を利用した Envoy の設定ファイルの管理」についてご紹介します。</p><h4>カウシェにおける Envoy の利用</h4><p><a href="https://www.envoyproxy.io/">Envoy</a> は、<a href="https://istio.io/latest/about/service-mesh/">Istio service mesh</a> における Sidecar や、<a href="https://cloud.google.com/load-balancing/docs/https">Google Cloud の Cloud Load Balancing における HTTP Load Balancer の実装</a>などで利用されている、汎用的なネットワークプロキシです。カウシェでは、Microservices Architecture における API Gateway として Envoy を利用しています。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qDbketXptT20nN9-szZqqQ.png" /><figcaption>カウシェのアーキテクチャ</figcaption></figure><p>Envoy の設定は、<a href="https://www.envoyproxy.io/docs/envoy/latest/start/quick-start/configuration-static">YAML ファイルを用いて静的に記述する方法</a>と、<a href="https://www.envoyproxy.io/docs/envoy/latest/start/quick-start/configuration-dynamic-control-plane">Controle Plane を用いて動的に配布する方法</a>があります。カウシェでは、動的に配布する方法を視野に入れつつも、現状ではプロキシ先のサービスの数が比較的少ないため、静的に記述する方法を採用しています。</p><h4>Envoy の設定ファイルの管理における課題</h4><p>カウシェでは、下記のような複数の環境で Envoy を利用しています:</p><ul><li>本番環境</li><li>QA 環境</li><li>CI 環境</li><li>ローカル開発環境</li></ul><p>プロキシ先のサービスのアドレスがそれぞれの環境ごとに異なるため、Envoy の設定ファイルは各環境ごとに専用のものを作成する必要があります。しかし、プロキシ先のアドレス以外の設定は共通するものが多く、それらを環境ごとの設定ファイルに直接記述してしまうと、下記のように重複した記述が多い状態になってしまいます:</p><ul><li>本番環境の Envoy の設定ファイル</li></ul><pre>static_resources:<br>  listeners:<br>    - name: example<br>      address:<br>        socket_address:<br>          address: 0.0.0.0<br>          port_value: 8080<br>      filter_chains:<br>        - filters:<br>            - name: envoy.filters.network.http_connection_manager<br>              typed_config:<br>                &#39;@type&#39;: type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager<br>                access_log:<br>                  name: log<br>                  typed_config:<br>                    &#39;@type&#39;: type.googleapis.com/envoy.extensions.access_loggers.stream.v3.StdoutAccessLog<br>                    log_format:<br>                      json_format:<br>                        protocol: &#39;%PROTOCOL%&#39;<br>                        method: &#39;%REQ(:METHOD)%&#39;<br>                        path: &#39;%REQ(:PATH)%&#39;<br>                        host: &#39;%REQ(HOST)%&#39;<br>                http_filters:<br>                  - name: envoy.filters.http.router<br>                    typed_config:<br>                      &#39;@type&#39;: type.googleapis.com/envoy.extensions.filters.http.router.v3.Router<br>                route_config:<br>                  virtual_hosts:<br>                    - name: production.example.com<br>                      domains:<br>                        - production.example.com<br>                      routes:<br>                        - match:<br>                            prefix: /<br>                          route:<br>                            cluster: service-1<br>  clusters:<br>    - name: service-1<br>      type: STRICT_DNS<br>      lb_policy: ROUND_ROBIN<br>      load_assignment:<br>        cluster_name: service-1<br>        endpoints:<br>          - lb_endpoints:<br>              - endpoint:<br>                  address:<br>                    socket_address:<br>                      address: production-service-1.example.com<br>                      port_value: 443</pre><ul><li>QA 環境の Envoy の設定ファイル</li></ul><pre>static_resources:<br>  listeners:<br>    - name: example<br>      address:<br>        socket_address:<br>          address: 0.0.0.0<br>          port_value: 8080<br>      filter_chains:<br>        - filters:<br>            - name: envoy.filters.network.http_connection_manager<br>              typed_config:<br>                &#39;@type&#39;: type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager<br>                access_log:<br>                  name: log<br>                  typed_config:<br>                    &#39;@type&#39;: type.googleapis.com/envoy.extensions.access_loggers.stream.v3.StdoutAccessLog<br>                    log_format:<br>                      json_format:<br>                        protocol: &#39;%PROTOCOL%&#39;<br>                        method: &#39;%REQ(:METHOD)%&#39;<br>                        path: &#39;%REQ(:PATH)%&#39;<br>                        host: &#39;%REQ(HOST)%&#39;<br>                http_filters:<br>                  - name: envoy.filters.http.router<br>                    typed_config:<br>                      &#39;@type&#39;: type.googleapis.com/envoy.extensions.filters.http.router.v3.Router<br>                route_config:<br>                  virtual_hosts:<br>                    - name: qa.example.com<br>                      domains:<br>                        - qa.example.com<br>                      routes:<br>                        - match:<br>                            prefix: /<br>                          route:<br>                            cluster: service-1<br>  clusters:<br>    - name: service-1<br>      type: STRICT_DNS<br>      lb_policy: ROUND_ROBIN<br>      load_assignment:<br>        cluster_name: service-1<br>        endpoints:<br>          - lb_endpoints:<br>              - endpoint:<br>                  address:<br>                    socket_address:<br>                      address: qa-service-1.example.com<br>                      port_value: 443</pre><p>例えば、上記 2 つの環境の設定ファイルは、Cluster のアドレスや Route のドメインの設定は異なりますが、大部分の設定は共通しています。</p><p>共通する設定を一箇所に切り出して管理するために、当初は YAML のための Templating ツールである<a href="https://github.com/vmware-tanzu/carvel-ytt">ytt</a> の利用を検討していました。 ytt を利用することで、YAML 上に独自のコメントによる記法を用いて条件分岐やループといった処理を記述することができます。ytt は YAML の延長線上で様々な処理を記述できる優れたツールではありますが、処理が複雑化した場合に yttの記法によって記述された YAML を読み解くのが難しくなってしまうことを懸念して採用を見送りました。</p><p>上記の ytt をはじめとしたいくつかの手法を検討し、最終的には CUE を利用して設定ファイルを管理する方法にたどり着きました。</p><h4>CUE による Envoy の設定ファイルの管理</h4><p><a href="https://cuelang.org/">CUE</a> は、様々な構造のデータの定義や生成、Validation を行うことを目的とした言語です。CUE は、条件分岐やループ、関数呼び出しやモジュールなどの機能を備えており、データ構造を柔軟に表現することができます。YAML や JSON などの一般的に利用されるデータ構造についても標準機能として提供しており、CUE で記述したデータをそれらの構造に変換することができます。</p><p>カウシェでは、この CUE を利用して Envoy の設定ファイルを生成しています。具体的には、共通する設定を CUE の package として切り出し、各環境ごとに作成する CUE の package から利用することで重複した処理を一箇所にまとめて管理しています:</p><ul><li>Envoy の共通する設定を切り出した CUE の package</li></ul><pre>package config<br><br>import (<br> &quot;list&quot;<br>)<br><br>#Input: {<br> hosts: [...#Host]<br>}<br><br>#Host: {<br> domain: string<br> routes: [...#Route]<br>}<br><br>#Route: {<br> path:     string<br> upstream: #Upstream<br>}<br><br>#Upstream: {<br> name:    string<br> address: string<br> port:    number<br>}<br><br>#Bootstrap: {<br> input: #Input<br><br> config: {<br>  static_resources: {<br>   listeners: [{<br>    name: &quot;example&quot;<br>    address: socket_address: {<br>     address:    &quot;0.0.0.0&quot;<br>     port_value: 8080<br>    }<br>    filter_chains: [{<br>     filters: [{<br>      name: &quot;envoy.filters.network.http_connection_manager&quot;<br>      typed_config: {<br>       &quot;@type&quot;: &quot;type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager&quot;<br>       access_log: {<br>        name: &quot;log&quot;<br>        typed_config: {<br>         &quot;@type&quot;: &quot;type.googleapis.com/envoy.extensions.access_loggers.stream.v3.StdoutAccessLog&quot;<br>         log_format:<br>          json_format: {<br>           protocol: &quot;%PROTOCOL%&quot;<br>           method:   &quot;%REQ(:METHOD)%&quot;<br>           path:     &quot;%REQ(:PATH)%&quot;<br>           host:     &quot;%REQ(HOST)%&quot;<br>          }<br>        }<br>       }<br>       http_filters: [<br>        {<br>         name: &quot;envoy.filters.http.router&quot;<br>         typed_config: &quot;@type&quot;: &quot;type.googleapis.com/envoy.extensions.filters.http.router.v3.Router&quot;<br>        },<br>       ]<br>       route_config: virtual_hosts: [<br>        for host in input.hosts {<br>         name: host.domain<br>         domains: [<br>          host.domain,<br>         ]<br>         routes: [<br>          for r in host.routes {<br>           match: {<br>            prefix: r.path<br>           }<br>           route: {<br>            cluster: r.upstream.name<br>           }<br>          },<br>         ]<br>        },<br>       ]<br>      }<br>     }]<br>    }]<br>   }]<br><br>   clusters: list.FlattenN([ for host in input.hosts {<br>    [<br>     for route in list.Concat([host.routes]) {<br>      name:      route.upstream.name<br>      type:      &quot;STRICT_DNS&quot;<br>      lb_policy: &quot;ROUND_ROBIN&quot;<br>      load_assignment: {<br>       cluster_name: route.upstream.name<br>       endpoints: [{<br>        lb_endpoints: [{<br>         endpoint: address: socket_address: {<br>          address:    route.upstream.address<br>          port_value: route.upstream.port<br>         }<br>        }]<br>       }]<br>      }<br>     },<br>    ]<br>   },<br>   ], 1)<br>  }<br> }<br>}</pre><ul><li>本番環境の Envoy の設定を表現する CUE の package</li></ul><pre>package production<br><br>import &quot;path/to/config&quot;<br><br>bootstrap: config.#Bootstrap &amp; {<br> input: config.#Input &amp; {<br>  hosts: [<br>   config.#Host &amp; {<br>    domain: &quot;production.example.com&quot;<br>    routes: [<br>     config.#Route &amp; {<br>      path:     &quot;/&quot;<br>      upstream: config.#Upstream &amp; {<br>       name:    &quot;service-1&quot;<br>       address: &quot;production-service-1.example.com&quot;<br>       port:    443<br>      }<br>     },<br>    ]<br>   },<br>  ]<br> }<br>}</pre><ul><li>QA 環境の Envoy の設定を表現する CUE の package</li></ul><pre>package qa<br><br>import &quot;path/to/config&quot;<br><br>bootstrap: config.#Bootstrap &amp; {<br> input: config.#Input &amp; {<br>  hosts: [<br>   config.#Host &amp; {<br>    domain: &quot;qa.example.com&quot;<br>    routes: [<br>     config.#Route &amp; {<br>      path:     &quot;/&quot;<br>      upstream: config.#Upstream &amp; {<br>       name:    &quot;service-1&quot;<br>       address: &quot;qa-service-1.example.com&quot;<br>       port:    443<br>      }<br>     },<br>    ]<br>   },<br>  ]<br> }<br>}</pre><p>上記のように、共通する設定を 1 つの package として切り出し、各環境ごとの package から利用することで、アドレスやドメインなどの環境ごとに異なる値以外を一箇所にまとめて管理しています。これらの CUE で記述した Envoy の設定を YAML ファイルとして出力するために、下記のようなコマンドを CUE で実装しています:</p><ul><li>各環境の CUE ファイルを元に YAML ファイルを生成する CUE のコマンド</li></ul><pre>package dump<br><br>import (<br> &quot;encoding/yaml&quot;<br> &quot;tool/file&quot;<br><br> &quot;path/to/production&quot;<br> &quot;path/to/qa&quot;<br> &quot;path/to/ci&quot;<br> &quot;path/to/local&quot;<br>)<br><br>command: gen: {<br> env: =~&quot;^(production|qa|ci|local)$&quot; | *_|_ @tag(env)<br><br> bootstrap_production: production.bootstrap<br> bootstrap_qa:         qa.bootstrap<br> bootstrap_ci:         ci.bootstrap<br> bootstrap_local:      local.bootstrap<br><br> write: file.Create &amp; {<br>  filename: &quot;./env/\(env)/envoy.yaml&quot;<br>  if env == &quot;production&quot; {<br>   contents: yaml.Marshal(bootstrap_production.config)<br>  }<br>  if env == &quot;qa&quot; {<br>   contents: yaml.Marshal(bootstrap_qa.config)<br>  }<br>  if env == &quot;ci&quot; {<br>   contents: yaml.Marshal(bootstrap_ci.config)<br>  }<br>  if env == &quot;local&quot; {<br>   contents: yaml.Marshal(bootstrap_local.config)<br>  }<br> }<br>}</pre><p>この CUE のコマンドを下記のように実行することで、CUE で記述した設定を、Envoy に渡すための YAML ファイルとして出力しています:</p><pre>&gt; cue -t env=production gen</pre><p>簡潔性のために、上記で紹介した CUE の実装からはカウシェで実際に利用している「環境による Wasm Filter の出し分け」や「特定の条件による HTTP リクエストやレスポンスへのヘッダーの付与」といったような複雑な処理は省きましたが、CUE を用いることでそれらの処理も package として切り出して再利用することが可能になっています。</p><h4>おわりに</h4><p>本稿では、カウシェで実践している CUE を利用した Envoy の設定ファイルの管理について解説しました。CUE は表現力が高く様々な構造のデータに対応しているので、Envoy の設定にとどまらず、例えば GitHub Actions などの設定に応用していくことも検討しています。みまさまもぜひ、CUE を利用した 設定ファイルの管理をお試しいただければと思います。</p><h4>宣伝</h4><p>カウシェでは、「世界一楽しいショッピング体験をつくる」ための Site Releiability Engineering を先導してくださるエンジニアを探しています。本稿で紹介したような CUE や Envoy の活用を含めて、常に「より良いアーキテクチャ」を模索しているエキサイティングな環境なので、興味を持っていただいた場合はぜひ採用情報をご覧いただければと思います。</p><ul><li><a href="https://hrmos.co/pages/kauche/jobs/0100078">【Software Engineer (Site Reliability Engineering)】シェア買いアプリ「カウシェ」のSoftware Engineerを募集します！ | 株式会社カウシェ</a></li><li><a href="https://enjoy-working.kauche.com/">カウシェ採用情報</a></li></ul><p>また、「カウシェについて聞いてみたい」「本稿で紹介した CUE と Envoy の活用について聞いてみたい」といったようなことがございましたら、<a href="https://twitter.com/mrno110">筆者の Twitter</a> の DM にて連絡いただければお答えさせていただきます。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f55a597bfaf6" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/managing-envoy-configurations-by-cue-f55a597bfaf6">CUE を利用した Envoy の設定ファイルの管理</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[SwiftUI で「グループスタンプ」というチャット機能を5日間で作った話]]></title>
            <link>https://medium.com/kauche/swiftui-group-chat-812cd6636e49?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/812cd6636e49</guid>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[swiftui]]></category>
            <category><![CDATA[ios]]></category>
            <dc:creator><![CDATA[トビ（tobi462）]]></dc:creator>
            <pubDate>Wed, 14 Dec 2022 09:59:54 GMT</pubDate>
            <atom:updated>2022-12-14T09:59:54.062Z</atom:updated>
            <content:encoded><![CDATA[<p>どうも、複業で「カウシェ」の iOS アプリ開発に参画させていただいているトビ（<a href="https://twitter.com/tobi462">@tobi462</a> ）です。</p><p>iOS テスト本の著者、あるいは最近では <a href="https://github.com/YusukeHosonuma/Effective-SwiftUI">Effective SwiftUI</a> の著者、という自己紹介が伝わりやすいでしょうか。</p><p><a href="https://github.com/YusukeHosonuma/Effective-SwiftUI">GitHub - YusukeHosonuma/Effective-SwiftUI: 📘 Effective SwiftUI</a></p><p>今回、複業という立場ながら<a href="https://adventar.org/calendars/7660">アドベントカレンダー</a>を執筆する機会をいただいたので、先日リリースされた <strong>グループスタンプ機能</strong> について、どのように SwiftUI で開発・実装されたかを実際のコードを追いながら、順を追って詳細に解説してみたいと思います。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/586/1*Y6_g_kXbLQO1hCbrTVufug.png" /><figcaption>先日リリースされたばかりのグループチャット機能</figcaption></figure><h3>私とカウシェ</h3><p>最初に軽く私とカウシェの関わりについて触れたいと思います。（興味ないよ、という方は適当に読み飛ばしていただければと思います）</p><p>カウシェには今年の6月から複業として参画させていただいています。</p><p>カウシェでは <strong>初期の頃から SwiftUI を採用</strong> しており、プライベートで SwiftUI を学習していた私にとって、相性の良いと感じたのが最初のきっかけでした。</p><p>ただ、私にとって決定打になった最大の理由はそのビジョンにありました。</p><p><a href="https://about.kauche.com/#vision"><strong>『世界一楽しいショッピング体験をつくる』</strong></a></p><p>面談いただいた時に CPO である <a href="https://twitter.com/akifumifukaya/">akifumi</a> さんからこの言葉を聞いた時、一言でいえば <strong>痺れました</strong> 。</p><p>殆ど受け売りになってしまいますが、既存の EC サービスでは効率化によって利便性が向上している一方、ウィンドウショッピングや友人との買い物を楽しむと言った、 <strong>本来のショッピングの楽しさが失われている</strong> という側面もあります。</p><p>そういった <strong>本来のショッピングの楽しさを取り戻しつつ、同時にお得に買い物を楽しめる世界をつくる、というある意味では壮大なチャレンジに挑もうとしている</strong> のがカウシェというスタートアップです。</p><p>後に CEO である <a href="https://twitter.com/mompyyy">Mon</a> さんの情熱を聞いたり、全力で最高のプロダクトを作ろうとしている人たちと一緒に仕事を進める中で、最大限貢献したいという気持ちが高まり、週の稼働日数が2日になった現在でも全力な気持ちでお仕事させていただいています。</p><h3>グループスタンプ機能とは？</h3><p>さて、あまり前置きが長くなっても仕方ないので、アドベントカレンダーらしく技術的な解説をしていきたいと思います。</p><p>まず、動画を見ていただくのが分かりやすいでしょう。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/295/1*OahzQi20dL8ElpyZi-i69g.gif" /><figcaption>グループスタンプ機能の様子（開発版）</figcaption></figure><p><strong>スタンプのみに限定されたチャット機能</strong> と表現するのが近いのでしょうか。</p><p>前述したとおり「カウシェ」では楽しいショッピング体験をゴールとして掲げており、その実現に向かう1つのステップとして開発されたのが今回の <strong>グループスタンプ機能</strong> です。</p><p>気になった商品や一緒に買いたいと思った商品について、 <strong>スタンプによる気軽なコミュニケーションで「シェア買い」というイベントを楽しんでもらう</strong> ことを目的としています。</p><p>それでは、この機能がどのような流れで開発されたか、実際のソースコードを交えながら解説していきます。（一部を改変しているコードもあります）</p><h3>吹き出しの Shape</h3><p>SwiftUI では <strong>小さな部品を組み合わせて大きなものを作る</strong> という思想があるので、小さめの部品から入り、少しずつ大きなところを見ていきたいと思います。多少の前後もありますが、実際の開発の進め方もほぼ同じ手順を踏んでいます。</p><p>まず最初に目に映るのは、灰色の吹き出しです。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/598/1*bDE7nf9t0urtgN8T2mQjPg.png" /><figcaption>スタンプで他の人とコミュニケーションできる</figcaption></figure><p>左側が<strong>「自分以外」</strong>、右側が<strong>「自分」</strong>という立ち位置になっていますが、灰色の吹き出しはどちらも同じ形状のものが水平方向に反転しただけなので、共通のものとして実装できそうです。</p><p>このような 2D 形状を作成する道具として、SwiftUI では <a href="https://developer.apple.com/documentation/swiftui/shapes">Shape</a> というものが用意されています。今回は自分でカスタム形状を定義することになりますが、標準でもいくつか用意されており、とくに <a href="https://developer.apple.com/documentation/swiftui/circle">Circle</a> や <a href="https://developer.apple.com/documentation/swiftui/capsule">Cupsule</a> などは利用頻度が高いのではないでしょうか。</p><pre>VStack {<br>    Circle().fill(Color.red)<br>    Capsule(style: .circular).stroke(Color.blue)<br>}<br>.frame(width: 200, height: 100)</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/348/1*-jypfpcWKpzdU0G6HZoSeQ.png" /></figure><p>今回はカスタム形状となるので Shape プロトコルに準拠し、以下のような形で実装することになります。</p><pre>struct XxxShape: Shape {<br>    func path(in rect: CGRect) -&gt; Path {<br>        // ここに`rect`に収まるパスを定義する<br>    }<br>}</pre><p>柔軟性をどこまで持たせるかはいつも迷いますが、今回は「角丸のサイズ」と「三角の大きさ」を外部から指定できるようにしました。</p><pre>struct ChatBaloonShape: Shape {<br>    /// 初期化。<br>    /// - Parameters:<br>    ///   - cornerRadius: 角丸のサイズ<br>    ///   - triangleSize: 三角（吹き出し）のサイズ<br>    init(cornerRadius: CGFloat, triangleSize: CGFloat) {<br>        self.cornerRadius = cornerRadius<br>        self.triangleSize = triangleSize<br>    }<br>}</pre><p>コードを書いていても定数として抽出したくなる値であり、外部から指定できるようにするのは殆ど手間ではなかったからです。また、現状では対応していませんが、端末の Dynamic Type の設定に合わせて調整したい場合にも便利でしょう。</p><p>コード全体は以下のようになりました。</p><pre>/// グループチャット用の吹き出し<br>public struct ChatBaloonShape: Shape {<br>    private var cornerRadius: CGFloat<br>    private var triangleSize: CGFloat<br><br>    /// 初期化。<br>    /// - Parameters:<br>    ///   - cornerRadius: 角丸のサイズ<br>    ///   - triangleSize: 三角（吹き出し）のサイズ<br>    public init(cornerRadius: CGFloat, triangleSize: CGFloat) {<br>        self.cornerRadius = cornerRadius<br>        self.triangleSize = triangleSize<br>    }<br><br>    public func path(in rect: CGRect) -&gt; Path {<br>        Path { path in<br>            // 右上角丸<br>            path.addArc(<br>                center: CGPoint(<br>                    x: rect.maxX - cornerRadius,<br>                    y: rect.minY + cornerRadius<br>                ),<br>                radius: cornerRadius,<br>                startAngle: Angle(degrees: 270),<br>                endAngle: Angle(degrees: 0),<br>                clockwise: false<br>            )<br><br>            // 右下角丸<br>            path.addArc(<br>                center: CGPoint(<br>                    x: rect.maxX - cornerRadius,<br>                    y: rect.maxY - cornerRadius<br>                ),<br>                radius: cornerRadius,<br>                startAngle: Angle(degrees: 0),<br>                endAngle: Angle(degrees: 90),<br>                clockwise: false<br>            )<br><br>            // 左下角丸<br>            path.addArc(<br>                center: CGPoint(<br>                    x: rect.minX + cornerRadius + triangleSize,<br>                    y: rect.maxY - cornerRadius<br>                ),<br>                radius: cornerRadius,<br>                startAngle: Angle(degrees: 90),<br>                endAngle: Angle(degrees: 180),<br>                clockwise: false<br>            )<br><br>            // 左上三角（吹き出し）<br>            path.addLine(to: CGPoint(x: triangleSize, y: triangleSize))<br>            path.addLine(to: .zero)<br>            path.closeSubpath()<br>        }<br>    }<br>}</pre><p>今回の形状はシンプルで、コード内容も複雑ではないので解説は省こうと思います。このあたりは調べればたくさんの情報が出てきますし、コード内容からも想像がつくかと思います。</p><p>Preview は以下のように書かれており、期待どおりに動いていることが確認できます。</p><pre>struct ChatBaloonShape_Previews: PreviewProvider {<br>    static var previews: some View {<br>        VStack {<br>            Group {<br>                ChatBaloonShape(cornerRadius: 16, triangleSize: 8)<br>                    .stroke(Color.black)<br><br>                ChatBaloonShape(cornerRadius: 32, triangleSize: 16)<br>                    .fill(Color.red.opacity(0.3))<br>            }<br>            .frame(width: 200, height: 140)<br>        }<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/504/1*69W1S2Xw0elA3XdEADu0Yg.png" /><figcaption>ChatBaloonShape のプレビュー結果</figcaption></figure><p>ちなみにカウシェでは UI 系の共通モジュールとして KaucheDesignKit を作成しており、これもその中に定義しています。（Initializer が public に定義されているのはこれが理由です）</p><h3>吹き出し View</h3><p>吹き出し用の Shape が作成できたので、次にスタンプ投稿の吹き出し View を作成したいと思います。</p><p>先ほどの Shape を灰色に塗りつぶし、その中にスタンプの画像を乗せればよさそうですが、自分と他の人とで吹き出しの方向が違うことが分かります。今回は SwiftUI の多くの API に習って enum で指定できるようにしてみました。</p><pre>enum AllowEdge {<br>    case leading<br>    case trailing<br>}</pre><p>この値によって Shape を反転させる必要がありますが、それは rotation3DEffect というモディファイアを利用して、Y軸で 180° 反転させる方法が使えます。</p><p>例えば、 Hello, world という Text を水平方向に反転させるコードは以下のようになります。</p><pre>Text(&quot;Hello, world&quot;)<br>    .rotation3DEffect(.degrees(180), axis: (x: 0, y: 1, z: 0))</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/396/1*WOpHDE1xPKauiFCWHGCCAA.png" /><figcaption>rotation3DEffect を使用して水平方向に反転</figcaption></figure><p>これをそのまま利用しても良いですが、こうした「水平方向に反転する」という使い方は多そうですし、可読性の面からもそれが簡単に読み取れると理想的です。</p><p>そこで、View の extension にて以下のような関数を定義しました。</p><pre>extension View {<br>    /// Y軸で反転させる。<br>    /// - Parameter enabled: `true`なら反転。`false`ならそのまま。（デフォルトは`true`）<br>    /// - Returns: 結果<br>    func horizontalFlipped(_ enabled: Bool) -&gt; some View {<br>        rotation3DEffect(.degrees(enabled ? 180 : 0), axis: (x: 0, y: 1, z: 0))<br>    }<br>}</pre><p>これは関数名から作用が想像しやすいですし、何より今後同じ処理を行いたい時に再利用できます。</p><p>最終的なコードは以下のようになりました。</p><pre>/// スタンプ用のバルーン<br>struct ChatStampBaloon: View {<br>    var stamp: Stamp<br>    var edge: AllowEdge<br><br>    var body: some View {<br>        ChatBaloonShape(cornerRadius: 16, triangleSize: 8)<br>            .fill(Color.gray) // 灰色で塗りつぶし<br>            .frame(width: 200, height: 173)<br>            .horizontalFlipped(edge == .trailing) // 反転<br>            .overlay {<br>                if let url = URL(string: stamp.url) {<br>                    URLImage(...) // スタンプ画像をオーバーレイで表示<br>                }<br>            }<br>    }<br><br>    enum AllowEdge {<br>        case leading<br>        case trailing<br>    }<br>}</pre><p>先ほど作成した ChatBaloonShape を灰色で塗りつぶし、 edge の値に応じて反転を行い、その上にスタンプ画像を overlay で表示しています。</p><p>ちなみに画像を非同期で取得する処理には <a href="https://github.com/dmytro-anokhin/url-image">URLImage</a> という OSS を利用しています。</p><p><a href="https://github.com/dmytro-anokhin/url-image">GitHub - dmytro-anokhin/url-image: AsyncImage before iOS 15. Lightweight, pure SwiftUI Image view, that displays an image downloaded from URL, with auxiliary views and local cache.</a></p><p>カウシェでは iOS 14+ をサポートしているために OSS を利用していますが、iOS 15+ であれば標準の <a href="https://developer.apple.com/documentation/swiftui/asyncimage">AsyncImage</a> を利用するのがよい選択かもしれません。</p><h3>スタンプ投稿 View（自分）</h3><p>さて、ここまでくれば自分と他の人のスタンプ投稿の View を作成するのは簡単です。</p><p>よりシンプルな「自分」の View から作成してみます。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/490/1*NGGGBlvay7646NaKBWPwkg.png" /><figcaption>自分のスタンプ投稿</figcaption></figure><p>コードは以下のようになります。</p><pre>/// スタンプ投稿（自分）<br>struct ChatBaloonMy: View {<br>    var stamp: Stamp<br>    var createTime: Date<br><br>    var body: some View {<br>        HStack(alignment: .bottom) {<br>            // タイムスタンプ<br>            timestamp(date: createTime)<br>                .multilineTextAlignment(.trailing)<br><br>            // 吹き出し<br>            ChatStampBaloon(stamp: stamp, edge: .trailing)<br>        }<br>    }<br>}</pre><p>HStack(alignment: .bottom) でタイムスタンプと吹き出しを配置するというシンプルなコードです。</p><p>タイムスタンプ部分は共通で使いたくなるはずなので、同一ソース内に以下のような関数を定義しました。</p><pre>private func timestamp(date: Date) -&gt; some View {<br>    Text(<br>        &quot;&quot;&quot;<br>        \(date.Md_JP())<br>        \(date.Hmm())<br>        &quot;&quot;&quot;<br>    )<br>    .font(.caption)<br>    .foregroundColor(Color.gray)<br>}</pre><p>なお、SwiftUI の文脈からは外れますが、可読性を損なわないように日付のフォーマットは extension で定義しています。</p><pre>// swiftlint:disable identifier_name<br><br>extension Date {<br>    /// `H:mm`形式でフォーマット<br>    /// - Returns: 結果<br>    func Hmm() -&gt; String {<br>        DateFormatter.Hmm.string(from: self)<br>    }<br><br>    /// `M月d日`形式でフォーマット<br>    /// - Returns: 結果<br>    func Md_JP() -&gt; String {<br>        DateFormatter.Md_JP.string(from: self)<br>    }<br>}<br><br>extension DateFormatter {<br>    /// `H:mm`形式<br>    static let Hmm: DateFormatter = create(&quot;H:mm&quot;)<br><br>    /// `M月d日`形式<br>    static let Md_JP: DateFormatter = create(&quot;M月d日&quot;)<br>}<br><br>private func create(_ format: String) -&gt; DateFormatter {<br>    let formatter = DateFormatter()<br>    formatter.dateFormat = format<br>    return formatter<br>}</pre><p>ちなみに Hmm や Md_JP といった識別子は Swift において一般的ではなく、SwiftLint のデフォルトのルール設定では弾かれるようになっています。</p><p>しかし、ここでは可読性を優先して意図的にルールから除外しています。</p><h3>スタンプ投稿 View（他の人）</h3><p>次に「他の人」の View を作成してみます。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/588/1*2vg2wpA1ZnHqXh4z5lKXwA.png" /><figcaption>他の人のスタンプ投稿</figcaption></figure><p>といっても、こちらもプロフィールのアイコン・ニックネームが追加されているのを除けば一緒なので、少しレイアウトが複雑になる程度です。</p><pre>struct ChatBaloonOther: View {<br>    var stamp: Stamp<br>    var profile: UserProfile<br>    var createTime: Date<br><br>    var body: some View {<br>        HStack(alignment: .top, spacing: 8) {<br>            // プロフィールアイコン<br>            NavigationLink {<br>                FollowProfileView(...)<br>            } label: {<br>                ProfileIconView(url: URL(string: profile.icon.url), size: 40)<br>            }<br><br>            VStack(alignment: .leading, spacing: 2) {<br>                // ニックネーム<br>                Text(profile.nickName)<br>                    .font(.caption)<br>                    .foregroundColor(Color.gray)<br>                    .padding(.leading, 8)<br><br>                HStack(alignment: .bottom) {<br>                    // 吹き出し<br>                    ChatStampBaloon(stamp: stamp, edge: .leading)<br><br>                    // タイムスタンプ<br>                    timestamp(date: createTime)<br>                        .multilineTextAlignment(.leading)<br>                }<br>            }<br>        }<br>    }<br>}</pre><p>プロフィールアイコンは、すでに共通部品として作成されていた ProfileIconView を利用しています。このように共通 View を簡単に作成・再利用できるのは SwiftUI の利点と言えます。</p><p>さて、これで「自分」と「他の人」の両方の View の作成が終わったことになります。</p><p>カウシェでは基本的に1ソースに1 Viewという構成になっていますが、これらの View は関連性が非常に高く、Preview も一緒に見たいと思ったので1ソース内にまとめています。（将来的に変更・調整する際も便利でしょう）</p><pre>import KaucheMockKit // モック用のデータ定義<br><br>struct ChatBaloonOther_Previews: PreviewProvider {<br>    static var previews: some View {<br>        VStack(spacing: 16) {<br>            // 自分<br>            ChatBaloonMy(<br>                stamp: .init(number: 1),<br>                createTime: timestamp(&quot;2022/9/4 1:23&quot;)<br>            )<br>            .frame(maxWidth: .infinity, alignment: .trailing)<br><br>            // 相手<br>            ChatBaloonOther(<br>                stamp: .init(number: 2),<br>                profile: .init(...),<br>                createTime: timestamp(&quot;2022/11/14 11:23&quot;)<br>            )<br>            .frame(maxWidth: .infinity, alignment: .leading)<br>        }<br>        .padding()<br>    }<br><br>    static func timestamp(_ dateString: String) -&gt; Date {<br>        DateFormatter.yyyyMMdd_HHmm.date(from: dateString)!<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/920/1*JBx5W8RjL-UaxXwYo5Xs1Q.png" /><figcaption>投稿スタンプのプレビュー（別の View だが1ソースにまとめている）</figcaption></figure><p>KaucheMockKit というモジュールを import していますが、これはモック用のデータが定義されたモジュールで、今回のような Preview やテストコードにおいて活用されています。</p><p>今回はそこにデータを定義したおかげで stamp: .init(number: 1) のようにノイズの少ない記述になっています。</p><h3>その他のセル</h3><p>さて、これでチャット用の View が揃ったわけですが、一覧にはシステムメッセージ・システムスタンプなども表示される仕様になっています。</p><p>先に Preview を見ていただくのが分かりやすいでしょう。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/908/1*hggwg6VmkcSsrnU0NGMFpA.png" /></figure><p>これらを ScrollView 内で分岐するのは見通しが悪くなると考え、以下のように1行に対応する View を作成しました。</p><pre>struct GroupChatRow: View {<br>    var message: GroupMessage<br><br>    var body: some View {<br>        switch message.message {<br>        case let .systemMessage(message):<br>            ...<br><br>        case let .systemStamp(stamp):<br>            ...<br><br>        case let .myStamp(stamp):<br>            ChatBaloonMy(stamp: stamp, createTime: message.createTime)<br>                .frame(maxWidth: .infinity, alignment: .trailing)<br><br>        case let .otherUserStamp(stamp, profile):<br>            ChatBaloonOther(stamp: stamp, profile: profile, createTime: message.createTime)<br>                .frame(maxWidth: .infinity, alignment: .leading)<br>        }<br>    }<br>}</pre><p>コード内容はシンプルですが、さきほどのスクリーンショットのように Preview でパターンを網羅することで、全体の表示バランスなどを確認しやすいメリットもあります。（チーム内で本記事をレビューいただいたところ、どうやら Android においても同様の意思決定がされていたようです）</p><h3>チャット画面</h3><p>それではいよいよチャット画面を作成したいと思います。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/568/1*mi4uUCy3LUnANpyeW8__Dw.png" /><figcaption>グループチャット画面</figcaption></figure><p>最初に今回の要件を整理したいと思います。</p><ul><li>下から上に向かって「新しい → 古い」というデータの並び順</li><li>上までスクロールしたら追加読込（ページング）</li><li>下部に固定されたボタンで「スタンプ選択用のシート」が立ち上がる</li><li>そこでスタンプが選択されるとシートが閉じ、末端にデータが追加・スクロールされる</li></ul><p>チャットアプリによくある「自動更新（新着）」や「入力中…」といった機能はありませんが、それでもそれなりに込み入っています。</p><p>1つずつ順に見ていきたいと思います。</p><h4>一覧データを表示する</h4><p>これはさほど難しくありません。</p><p>画面表示時に API を叩いて必要なデータを取得し、それを ScrollView + LazyVStack に流し込むだけで大丈夫なはずです。</p><p>1つ注意点があるとすれば、他のチャットアプリに（Slack で言えば「チャンネル」）といった独立した会話スペースがあるように、カウシェでは「シェア買いのグループ」を独立した会話スペースにする必要がある点です。</p><p>なので、画面を表示する際には「グループ ID」を渡すインターフェースになります。</p><p>カウシェでは MVVM アーキテクチャを採用しており、実際の通信は ViewModel を行うことになるため、イニシャライザは以下のような形になります。</p><pre>/// グループチャット画面<br>struct GroupChatView: View {<br>    @StateObject private var viewModel: GroupChatViewModel<br><br>    /// 初期化。<br>    /// - Parameter groupId: グループID<br>    init(groupId: String) {<br>        _viewModel = .init(wrappedValue: .init(groupId: groupId))<br>    }<br>}</pre><p>一時期話題になりましたが、 <a href="https://developer.apple.com/documentation/swiftui/stateobject/init(wrappedvalue:)">@StateObject のドキュメント</a>には Initializer を直接呼び出してはいけないという記載があるものの、WWDC 21 のデジタルラウンジにて「初期化のタイミングで一度だけ呼び出すのは問題ない」という回答がなされています。</p><p><a href="https://swiftui-lab.com/random-lessons/#data-10">Random Lessons from the SwiftUI Digital Lounge - The SwiftUI Lab</a></p><p>ところで、実際に通信する時は「読み込み中のインジケータ」を表示したり、通信に失敗したら「リトライするための画面」を表示する必要があります。</p><p>これは前後する形になってしまうのですが、今回の開発で LoadingContentView という共通 View を作成しており、ViewModel も含めると以下のような形になっています。</p><pre>var body: some View {<br>    LoadingContentView(fetcher: viewModel.onInit) { data in<br>        // 読込が成功した時に表示するコンテンツ<br>    }<br>}<br><br>@MainActor<br>final class GroupChatViewModel: ObservableObject {<br>    private let useCase: GroupChatUseCase<br><br>    /// メッセージ一覧<br>    @Published var messages: [GroupMessage] = []<br><br>    /// 次のページトークン<br>    @Published var nextPageToken: String = &quot;&quot;<br><br>    /// 初期化。<br>    /// - Parameter groupId: グループID<br>    init(groupId: String) {<br>        self.groupId = groupId<br>        self.useCase = .init(groupId: groupId)<br>    }<br><br>    /// 初期読込<br>    func onInit() async throws {<br>        let response = try await useCase.fetchMessages(pageToken: &quot;&quot;)<br>        messages = response.messages<br>        nextPageToken = response.nextPageToken<br>    }<br>}</pre><p>カウシェではすでに Swift Concurrency を導入しており、新規で開発する機能については Combine ではなく async/await を利用しています。</p><p>LoadingContentView に渡された viewModel.onInit によって初期読込が発火し、画面に表示するデータ一覧である messagesという Publishedプロパティに API から取得されたデータを格納しています。</p><p>なお説明は割愛しますが、 LoadingContentView は以下のようにして実装されています。</p><pre>/// 通信中・エラー・再読み込みを備えた View<br>struct LoadingContentView&lt;Content: View, Data&gt;: View {<br>    @StateObject private var viewModel: LoadingContentViewModel&lt;Data&gt;<br>    @ViewBuilder private var content: (Data) -&gt; Content<br><br>    init(<br>        fetcher: @escaping () async throws -&gt; Data,<br>        content: @escaping (Data) -&gt; Content<br>    ) {<br>        _viewModel = .init(wrappedValue: .init(fetcher: fetcher))<br>        self.content = content<br>    }<br><br>    var body: some View {<br>        switch viewModel.state {<br>        case .loading:<br>            AppLoadingView()<br><br>        case .error:<br>            ErrorView(...)<br><br>        case let .loaded(data):<br>            content(data)<br>        }<br>    }<br>}</pre><p>そして、対応する LoadingContentViewModel は以下のように実装されています。</p><pre>@MainActor<br>final class LoadingContentViewModel&lt;Data&gt;: ObservableObject {<br>    typealias Fetcher = () async throws -&gt; Data<br><br>    @Published var state: State = .loading<br><br>    private let fetcher: Fetcher<br><br>    init(fetcher: @escaping Fetcher) {<br>        self.fetcher = fetcher<br>        Task {<br>            await reload()<br>        }<br>    }<br>}<br><br>// MARK: Data<br><br>extension LoadingContentViewModel {<br>    enum State {<br>        case loading<br>        case error<br>        case loaded(Data)<br>    }<br>}<br><br>// MARK: Event<br><br>...</pre><p>さて、最後は View 側で messages を参照して、データが表示すればよいはずです。</p><pre>ScrollView {<br>    LazyVStack(spacing: 16) {<br>        // 😀 スタンプ一覧<br>        ForEach(viewModel.messages) { message in<br>            GroupChatRow(message: message)<br>        }<br>    }<br>    .padding(.horizontal, 16)<br>}</pre><p>ここで、先ほど作成した1行用の GroupChatRow を利用しています。</p><p>ところで、このコードでは List ではなく ScrollView ＋ LazyVStack という構成を利用していますが、これはカウシェが iOS 14+ をサポートしており、その場合に List の罫線の制御が面倒になるためです。</p><h4>追加読込における課題</h4><p>続いて追加読込です。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/295/1*XkUss6EwBBEicyMM_pSmAA.gif" /><figcaption>上までスクロールされたら追加読込される</figcaption></figure><p>これは他画面でも実装済みのもので、大雑把な実装としては末尾のセルが onAppear されたタイミングで追加読込をコールといった方法で行えるので一見すると簡単そうです。（厳密に考えだすともっと複雑なのですが）</p><p>しかし、ここでは他画面と異なり <strong>一番上までスクロールされたら追加読込</strong> という仕様であるため、スムーズな UI を実現しようと一筋縄には行かないことが分かります。</p><p>追加で取得したデータを messages プロパティに追加すると、その分のデータが一気に画面に表示され、急に画面がスクロールされたように見えてしまいます。</p><p>これは ScrollView の offset を考えると分かりやすいですが、例えば offset=0 にスクロールされていたとして、追加読込用のデータが先頭に追加されても ScrollView は依然として offset=0 の状態が持続されることになり、結果として急にスクロールされたように見えてしまうわけです。</p><p>これは一見すると難問に見えますが、すでにこの記事に登場したテクニックで解決できるのですが、ピンと来る方はいるでしょうか。</p><h4>追加読込の解決方法</h4><p>正解は rotation3DEffect モディファイアで、これによって ScrollView を上下反転させてしまうという方法が使えます。そうすれば他の画面と同様、 ScrollView の上端ではなく下端で追加読込を行うというロジックをそのまま利用できることになります。</p><p>もちろんそのままでは中身の View も上下反転してしまうので、そちらも同様に上限反転させ、全体として辻褄を合わせるようにします。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/784/1*2euWCJcgGXjIEROxVKI1ew.png" /><figcaption>ScrollView のみを上下反転させた様子</figcaption></figure><p>前回、Y軸で反転させる拡張関数を作成したので、今回はX軸で反転させる拡張関数を作成できます。</p><pre>extension View {<br>    /// X軸で反転させる。<br>    /// - Parameter enabled: `true`なら反転。`false`ならそのまま。（デフォルトは`true`）<br>    /// - Returns: 結果<br>    func verticalFlipped(_ enabled: Bool = true) -&gt; some View {<br>        rotation3DEffect(.degrees(enabled ? 180 : 0), axis: (x: 1, y: 0, z: 0))<br>    }<br>}</pre><p>このままでも良いですが、せっかくなので SwiftUI らしい統合された API にリファクタリングしてみます。</p><pre>/// 水平方向または上下方向に反転させる。<br>/// - Parameters:<br>///   - axis: 反転方向<br>///   - enabled: 反転を有効にするかどうか。<br>/// - Returns: 結果<br>@ViewBuilder<br>func flipped(_ axis: Axis, enabled: Bool = true) -&gt; some View {<br>    switch axis {<br>    case .vertical:<br>        rotation3DEffect(.degrees(enabled ? 180 : 0), axis: (x: 1, y: 0, z: 0))<br>    case .horizontal:<br>        rotation3DEffect(.degrees(enabled ? 180 : 0), axis: (x: 0, y: 1, z: 0))<br>    }<br>}</pre><p>これによって flipped(.vertical) といった直感的で利用しやすい API になりました。</p><p>実際に利用したコードは以下のようになります。</p><pre>ScrollView {<br>    LazyVStack(spacing: 16) {<br>        // 😀 スタンプ一覧<br>        ForEach(viewModel.messages) { message in<br>            GroupChatRow(message: message)<br>                .flipped(.vertical) // セルを上下反転<br>        }<br>    }<br>    .padding(.horizontal, 16)<br>}<br>.flipped(.vertical) // ScrollView を上下反転</pre><p>ScrollView を上下反転させたら、ジェスチャも反転してしまうのではないかと予想される方もいるかもしれませんが、そのあたりは賢く処理されておりジェスチャも自動的に補正されます。</p><p>ちなみに Z 軸で回転させる <a href="https://developer.apple.com/documentation/swiftui/view/rotationeffect(_:anchor:)">rotationEffect</a>というモディファイアも存在します。</p><p>わざわざ rotation3DEffect を利用せずとも、こちらで180°回転させれば良いと感じるかもしれませんが、 ScrollView には右端にインジケータ表示があるため、 rotationEffect で回転させた場合にはインジケータが左側に移動してしまうという問題があります。</p><p>さて、あとは実際の追加読込です。</p><p>先述したように特定のセルでの onAppear で発火しても良いのですが、今回は GeometryReader + PreferenceKey を利用して <strong>スクロール位置を検知する</strong> 方法を採用してみました。</p><p>これは、その方が追加読込のタイミングを調整しやすく、（バックエンドの負荷と相談しながら）UI/UX の改善が容易になると判断したためです。</p><p>View 側のコードは以下のようになります。</p><pre>ScrollView {<br>    LazyVStack(spacing: 16) {<br>        // 😀 スタンプ一覧<br>        ForEach(viewModel.messages) { message in<br>            GroupChatRow(message: message)<br>                .flipped(.vertical)<br>        }<br><br>        // 🔄 追加読込インジケータ<br>        if viewModel.nextPageToken.isNotEmpty {<br>            LoadingIndicatorCell()<br>        }<br><br>        // 📐 スクロール検知<br>        GeometryReader { geometry in<br>            Space(height: 0)<br>                .preference(<br>                    key: OffsetPreferenceKey.self,<br>                    value: geometry.frame(in: .global).origin.y<br>                )<br>        }<br>    }<br>}<br>.flipped(.vertical)<br>.onPreferenceChange(OffsetPreferenceKey.self) { offset in<br>    // Note:<br>    // さらに早い段階で先読みしたい場合は数値を小さくしてもよい。（サーバ負荷は考慮のこと）<br>    if 0 &lt; offset {<br>        Task {<br>            await viewModel.onLoadMore()<br>        }<br>    }<br>}</pre><p>GeometryReader 内に定義された Space(height: 0) は利便性のために追加している独自の View で、 Spacer().frame(height: 0) のシンタックスシュガーとして利用しています。</p><pre>public struct Space: View {<br>    private var width: CGFloat?<br>    private var height: CGFloat?<br><br>    public init(width: CGFloat) {<br>        self.width = width<br>        self.height = nil<br>    }<br><br>    public init(height: CGFloat) {<br>        self.width = nil<br>        self.height = height<br>    }<br><br>    public var body: some View {<br>        if let width {<br>            Spacer().frame(width: width)<br>        } else if let height {<br>            Spacer().frame(height: height)<br>        }<br>    }<br>}</pre><p>ちなみにこれは Android プロジェクトにおいて同様の手法が行われており、それを iOS プロジェクトに輸入した形になります。</p><p>話を戻しますと、このダミーの View の位置を GeometryReader で計測してその Y 座標を preference を利用して上位 View に報告し、 onPreferenceChange で変化を観測し、特定の Y 座標を越したら追加読込を発火する、という作りになっています。</p><p>ここでは大雑把に .global を指定してグローバルフレームからの相対位置を取得していますが、より正確に計測したい場合には専用の名前空間を利用したほうが良いでしょう。</p><h3>スタンプ選択</h3><p>さて、次にスタンプ選択画面に着手します。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/582/1*JkWQ0Nk-bWiXssZeSNkmPA.png" /><figcaption>投稿するスタンプを選択するシート</figcaption></figure><p>直近の選択があれば「最近使ったスタンプ」に表示され、その下は「利用可能なすべてのスタンプ」という画面構成になっています。</p><p>多くの方が想像されるであろうとおり、ここでは iOS 14+ から利用可能な <a href="https://developer.apple.com/documentation/swiftui/lazyvgrid">LazyVGrid</a> を利用してスタンプのグリッド表示をしています。</p><p>使用履歴と一覧の両方で共通に利用したいため、ここでは以下のように共通関数を定義しています。（独立した View として定義するのも1つの方法でしょう）</p><pre>func stampsGrid(stamps: [Stamp]) -&gt; some View {<br>    LazyVGrid(columns: Array(repeating: GridItem(), count: 4)) {<br>        ForEach(stamps) { stamp in<br>            StampView(stamp: stamp)<br>                .onTapGesture {<br>                    Task {<br>                        await viewModel.onTapStamp(stamp: stamp)<br>                        dismiss()<br>                    }<br>                }<br>        }<br>    }<br>}</pre><p>onTapGesture でタップ処理を行っていますが、これについては後述したいと思います。</p><p>さて、中身のセルとして利用している StampView は以下のようにシンプルな View になっています。</p><pre>/// スタンプ一覧のスタンプ<br>struct StampView: View {<br>    var stamp: Stamp<br><br>    var body: some View {<br>        if let url = URL(string: stamp.url) {<br>            URLImage(<br>                url,<br>                inProgress: { _ in Color.clear },<br>                failure: { _, _ in Color.clear },<br>                content: { content in<br>                    content<br>                        .resizable()<br>                        .scaledToFit()<br>                }<br>            )<br>            .padding(2)<br>            .background {<br>                Color.gray.clipShape(RoundedRectangle(cornerRadius: 16))<br>            }<br>        }<br>    }<br>}</pre><p>ここまできて、なぜこんな単純なコードを紹介したのか疑問に思う方も多いでしょう。</p><p>実はこのコードのとある部分が現在の実装とは異なっていたのですが、（おそらく）それが原因となり iOS 14 限定で非常に奇妙なバグに遭遇していました。</p><p>私の zp チャンネルに発言が残っていたのでスクショを貼りたいと思います。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vlAg2CRCYd3lVs-xHqgHNg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*b7tKbagifK_XeQYjZI8ebg.png" /></figure><p>今となっても正確な原因は掴んでいないのですが、どうやら URLImage の inProgress の部分で EmptyViewを利用していたのがマズかったらしく、代わりに Color.clearに変更することで、この奇妙な不具合は一切再現しなくなりました。</p><p>これは予想でしかありませんが、iOS 14 における LazyVGrid のバグなのではないか、と疑っています。</p><p>本当の原因がどこにあったかはさておき、SwiftUI を利用した開発ではこうした奇妙なバグに遭遇することが稀にあり、そうした際には <strong>UIKit 時代より調査が難航する傾向にある</strong> と感じています。</p><p>SwiftUI の生産性は高いと感じていますが、こうした不具合に遭遇したときの<strong>対処工数が全く読めない</strong>という点は、現時点の評価として心に留めておく必要があると感じます。</p><h3>スタンプ投稿</h3><p>さて、先ほど後述するとした「スタンプがタップされた時の処理」ですが、具体的には以下のような処理を行っています。</p><ol><li>サーバ側に選択されたスタンプを送信</li><li>表示中の自分のシートを閉じる</li><li>一覧に選択されたスタンプを追加する</li></ol><p>まずは、ViewModel 側のコードを見てみたいと思います。</p><pre>/// スタンプ一覧画面<br>@MainActor<br>final class StampListViewModel: ObservableObject {<br>    /// スタンプ投稿完了時のコールバック<br>    private var onPostedStamp: (Stamp?) -&gt; Void<br><br>    /// スタンプタップ時<br>    func onTapStamp(stamp: Stamp) async {<br>        do {<br>            // 最近使ったスタンプを更新<br>            // （投稿に失敗した際にやり直しやすいように先に更新しておく）<br>            updateRecentSampts(stamp: stamp)<br><br>            // スタンプ投稿<br>            try await groupChatUseCase.postStamp(stampId: stamp.id)<br><br>            // フィードバック<br>            let generator = UINotificationFeedbackGenerator()<br>            generator.prepare()<br>            generator.notificationOccurred(.success)<br><br>            // コールバック（成功）<br>            onPostedStamp(stamp)<br>        } catch {<br>            // コールバック（失敗）<br>            onPostedStamp(nil)<br>        }<br>    }<br>}</pre><p>まず、最近使ったスタンプ（使用履歴）を先に更新しています。</p><p>これは UserDefaults に保持されるようになっているもので、サーバ側への送信に失敗した際に、利用者がストレスを最小限にやり直しできるようにする、という意図によるものです。（余談ですがこの仕様を提案したのは私です）</p><p>次にスタンプの送信に成功した場合には触覚フィードバックで成功を通知し、初期化時に渡されたコールバックを呼び出して結果を通知するようにしています。（厳密な話をすると UINotificationFeedbackGenerator.prepare はこの関数の先頭で呼び出したほうがベターかもしれません）</p><p>次にシートを閉じる処理ですが、これは先ほどの View 側のコードに記述されています。</p><pre>StampView(stamp: stamp)<br>    .onTapGesture {<br>        Task {<br>            await viewModel.onTapStamp(stamp: stamp)<br>            dismiss() // シートを閉じる<br>        }<br>    }</pre><p>厳密な MVVM を考えると、こうした処理は ViewModel 側の onTapStamp で完結するべきかもしれません。</p><p>しかし、そのためにはコールバックを引き渡す必要がありますし、当然ですがその分コード量は増えてしまいます。そして、コード量が増えればバグの可能性が増えますし、コードレビューのコストも上がってしまいます。</p><p>そういった点をトレードオフとして考慮し、厳密さよりシンプルさを意識して View 側でコードを記述しています。</p><p>ところで、鋭い方は dismiss() の部分に注目されたかもしれません。</p><p>シートを閉じるための Environment として <a href="https://developer.apple.com/documentation/swiftui/environmentvalues/dismiss">dismiss</a> が用意されていますが、これが利用可能なのは iOS 15+ からであり、iOS 14+ をサポートするカウシェでは利用できない API です。</p><p>実はこれは単に dismiss というヘルパー関数を用意しているだけです。</p><pre>func dismiss() {<br>    presentationMode.wrappedValue.dismiss()<br>}</pre><p>これは一見過剰な実装に見えるかもしれませんが、iOS 15+ の API に差し替えた際にコード修正が最小限で済むというメリットがあると予想しています。</p><h3>スタンプ投稿後の処理</h3><p>さて、最後にスタンプ一覧 View をシート表示している部分を見てみましょう。</p><pre>/// グループチャット画面<br>struct GroupChatView: View {<br>    @StateObject private var viewModel: GroupChatViewModel<br><br>    /// スタンプ一覧のシートを表示しているか<br>    @State private var isPresentedStampSheet: Bool = false<br><br>    var body: some View {<br>        LoadingContentView(fetcher: viewModel.onInit) { _ in<br>            ScrollViewReader { proxy in<br>                content()<br>                    .onChange(of: viewModel.scrollToBottom) { value in<br>                        if value != nil {<br>                            withAnimation {<br>                                proxy.scrollTo(&quot;bottom&quot;)<br>                            }<br>                        }<br>                    }<br>            }<br>            .overlay(alignment: .bottom, content: footer)<br>            .snackBar($viewModel.snackBarContent)<br>            .sheet(isPresented: $isPresentedStampSheet) {<br>                // スタンプ選択画面<br>                StampListView(<br>                    groupId: viewModel.groupId,<br>                    onPostedStamp: { stamp in<br>                        Task {<br>                            await viewModel.onPostedStamp(stamp)<br>                        }<br>                    }<br>                )<br>            }<br>        }<br>    }<br>}</pre><p>これは先述したチャット画面のコードで、途中で紹介した LoadingContentView および ScrollViewReader に囲まれた content() がここまで解説してきたチャット画面の中身の実装となっています。</p><p>まず、スタンプ画面をシート表示している箇所を見てみましょう。</p><pre>.sheet(isPresented: $isPresentedStampSheet) {<br>    // スタンプ選択画面<br>    StampListView(<br>        groupId: viewModel.groupId,<br>        onPostedStamp: { stamp in<br>            Task {<br>                await viewModel.onPostedStamp(stamp)<br>            }<br>        }<br>    )<br>}</pre><p>シート周りは標準的な使い方なので、特筆すべき点はないかと思います。</p><p>onPostedStamp のクロージャの部分が、前項で触れたコールバックの部分で、成功した場合は選択されたスタンプ、失敗した場合には nil が引数として渡されます。</p><p>ViewModel 側のコードは以下のようになっています。</p><pre>@MainActor<br>final class GroupChatViewModel: ObservableObject {<br><br>    /// 末端にスクロールするトリガー<br>    @Published var scrollToBottom: UUID?<br><br>    /// スタンプ投稿のコールバック<br>    func onPostedStamp(_ stamp: Stamp?) async {<br>        if stamp == nil {<br>            snackBarContent(L10n.Stamp.SnackBar.sendFailed)<br>        } else {<br>            do {<br>                // 最新のメッセージ一覧を取得して追加された分をマージ（ページトークンは更新しない）<br>                let response = try await useCase.fetchMessages(pageToken: &quot;&quot;)<br>                withAnimation {<br>                    messages = messages.mergeLatest(response.messages)<br>                }<br><br>                // 末端までスクロール<br>                scrollToBottom = .init()<br>            } catch {<br>                snackBarContent(L10n.Stamp.SnackBar.reloadFailed)<br>            }<br>        }<br>    }<br>}</pre><p>成功時には一覧の1ページ目を再取得し、その結果を一覧にマージするようにしています。</p><p>これにより利用者が選択したスタンプ、およびそれまでに他の人が送信したスタンプが画面に追加されることになります。</p><p>そして最後に末端まで自動スクロールするようにしています。</p><p>これは UUID 型で宣言されたトリガー用の変数を更新することで、それが View 側の onChange で補足され、 ScrollViewReaderProxyの scrollTo() を呼び出すという構造になっています。</p><pre>ScrollViewReader { proxy in<br>    content()<br>        .onChange(of: viewModel.scrollToBottom) { value in<br>            if value != nil {<br>                withAnimation {<br>                    proxy.scrollTo(&quot;bottom&quot;) // 末端までスクロール<br>                }<br>            }<br>        }<br>}</pre><p>こうした UUID と onChange(of:) ではなく、 PassthroughSubject と onReceive を利用することでも同等のことが可能です。</p><p>しかし、以前に後者の実装パターンを利用した際に、特定の条件が重なると正しく動かないケースがあったため、私はこのコーディングパターンで落ち着いています。（ UUID だと用途が広いので Trigger などの専用の型やモディファイアを用意するというのも1つの改善として考えられます）</p><h3>スナックバーの表示</h3><p>さて、ここまでに殆どの機能の主要なコードを見てきました。</p><p>さすがにこの記事も長くなりすぎたので、最後に通信エラーが発生した際の「スナックバー表示」の実装について解説して終わりにしたいと思います。</p><p>「スナックバー」とは Android 用語であり、正確に機能をコピーしたものではなく、現状のカウシェの iOS アプリでは画面下部に表示するトーストのようなものになっています。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/740/1*6XeeZsiHaMLCa1OsKaZbyw.png" /><figcaption>画面下部に一定時間スナックバーを表示する</figcaption></figure><p>まず、View 側については専用のモディファイアを用意し、 alert などと同じような感覚で使用できるようにしています。</p><pre>.snackBar($viewModel.snackBarContent)</pre><p>ViewModel 側の Published プロパティは、専用の型である SnackBarContent を用意し、それに表示したいメッセージを引数に与えて呼び出すことでスナックバーを表示しています。</p><pre>@MainActor<br>final class GroupChatViewModel: ObservableObject {<br><br>    /// スナックバー<br>    @Published var snackBarContent: SnackBarContent = .init()<br><br>    /// スタンプ投稿のコールバック<br>    func onPostedStamp(_ stamp: Stamp?) async {<br>        if stamp == nil {<br>            snackBarContent(L10n.Stamp.SnackBar.sendFailed) // スナックバー表示<br>        } else {<br>            ...<br>        }<br>    }<br>}</pre><p>鋭い方はお気づきかもしれませんが、これは Swift の callAsFuction という機能を利用しています。</p><pre>/// スナックバー表示用のコンテンツ<br>public struct SnackBarContent {<br>    public var isPresented: Bool = false<br>    public var message: String = &quot;&quot; {<br>        didSet {<br>            isPresented = true<br>        }<br>    }<br><br>    public init() {}<br><br>    /// 指定されたメッセージでスナックバーを表示<br>    /// - Parameter message: メッセージ<br>    public mutating func callAsFunction(_ message: String) {<br>        self.message = message<br>    }<br>}</pre><p>状態としては、表示中かどうかを表す isPresented と、表示中のメッセージである message の2つを保持しています。</p><p>callAsFunction 経由でコールされた際には message を更新し、 message の didSet で isPresented を true に更新することで、スナックバーを表示状態にするという仕組みにしています。</p><p>これによって snackBarContent.message = &quot;xxx&quot; ではなく snackBarContent(&quot;xxx&quot;) という簡潔で可読性の高い API になっています。（私は好みが分かれると思ったのですが、PR ではチームメンバーから好意的な意見を多く頂いたので採用する形になりました）</p><p>ところで、一見すると Single Source of Truth の考え方からすると messageを String? で宣言すれば、 nil を非表示状態として扱えるため isPresented を削除できるように感じます。</p><p>しかし、スナックバーはフェードアウトしながら消えるため、そのタイミングで message を nil に更新すると、そのタイミングでテキストが消えてしまうため意図したアニメーションになりません。</p><p>関数を共通化する際は、それが本当に共通のものなのか、あるいは似て非なるものなのかを考えることが大切とはよく言われますが、SwiftUI においてもそれが本当に <strong>唯一のデータソースとしてまとめられるかどうか</strong> を一考する場面もあります。</p><p>最近、アプリのパフォーマンス改善にも取り組んでいる際にもこうしたケースはあり、SwiftUI だからといって必ずしも（単純な意味での） Single Source of Truth が唯一の正解でないことは、軽く心に留めておくとよいかもしれません。</p><h3>まとめ</h3><p>さて、そんなわけで「グループスタンプ機能」について、どのように開発・実装がされたかを書かせていただきましたが、参考になる部分はあったでしょうか。</p><p>SwiftUI はある程度学習しても、実際に組み合わせて使おうとすると難しいことがあり、<strong>「実際のプロダクトで開発・リリースされた機能について、1から解説する」</strong>ような記事は需要があるのではないかと感じ、今回はこのような構成の記事にチャレンジさせていただきました。</p><p>もし需要があれば定期的にこうした形で技術共有していきたいという話も出ていますので、よろしければ<strong>「いいね」や 👏 </strong>などいただけますと幸いです。（おそらく一定数いけば、次回も記事を執筆する機会が得られると思います（笑）</p><p>タイトルにもあるように、iOS 側の機能は<strong>5日間</strong>で開発されました。</p><p>デザイナフィードバックや仕様変更、PR レビューも含め、QAが開始できるまでにかかった総日数（私は週2日稼働なので3分割されています）で、この記事で触れなかった機能・APIとのつなぎ込み・イベントログなどの実装も含まれています。</p><p>さらに、 <strong>QA でのバグは0件</strong>でした。</p><p>私は Twitter で SwiftUI の生産性の高さを評価するツイートを度々していますが、この記事で触れているように共通部品の実装や予期せぬ SwiftUI のバグも含めてこの日数ですから、やはり<strong> SwiftUI の生産性は高い</strong>と言わざるを得ません。（そして SwiftUI がさらに強力なのは、今後の仕様変更やリファクタリングでもあります）</p><p>私は普段、技術記事でこういった生産性については取り上げないの主義なのですが、<strong>SwiftUI での生産性についての実例があまり表に出ていない</strong>と感じ、今回は例外的に取り上げさせていただきました。</p><h3>仲間を募集しています</h3><p>多くのスタートアップのプロダクトがそうであるように、外から見るとすでに完成されたプロダクトに見えても、実際には <strong>まだまだやることは山のようにある</strong> というのはよくある話です。</p><p>「カウシェ」もその例に漏れず、今後の開発・改善スケジュールはぎっしりと詰まっています。</p><p>今回ご紹介させていただいたグループスタンプ機能もコミュニケーションの入り口でしかありませんし、よりお客様にあった商品を適切にレコメンドしたり、検索性を改善したり、あるいはシェア買いという軸以外から楽しいショッピング体験というものを切り開いていく必要もあるでしょう。</p><p>少なくとも私にとって、カウシェは <strong>最高の仕事場の1つ</strong> です。</p><p>前述したビジョンに加え、</p><ul><li>Try First</li><li>For Team</li><li>Enjoy Working</li></ul><p>という3つのValueも掲げており、それを土台にして最高の仲間達が最高のプロダクト・サービスを作ることに全力を捧げています。</p><p>エンジニアリングとして <strong>Try First </strong>の文化がよく機能しており、iOSアプリの技術的な面を見ても「SwiftUI」や「Concurrency」などをいち早く導入され、日々の生産性を確実に向上させる努力を怠っていません。（これは Android アプリチームにおいても同様です）</p><p>使い古された一文ではありますが…</p><p><strong>カウシェではビジョンに共感できる仲間を募集しています。</strong></p><p>現在はかなり多岐にわたった職種が募集されていますので、興味が出たら気軽にカジュアル面談などをしていただくのも良いかと思います。（優しい方ばかりです）</p><p><a href="https://enjoy-working.kauche.com/">カウシェ採用情報</a></p><p>さて、あまり長くなると締まらないので、今回はこのあたりで終わりにしたいと思います。</p><p>それでは、引き続き「カウシェ」でのショッピング体験をお楽しみくださいませ。</p><p><em>Merry Christmas, all shopping lovers.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=812cd6636e49" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/swiftui-group-chat-812cd6636e49">SwiftUI で「グループスタンプ」というチャット機能を5日間で作った話</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[FirestoreのCountクエリでコストとパフォーマンスは改善できるのか]]></title>
            <link>https://medium.com/kauche/go-firestore-count-478b24e6ff57?source=rss----14577f02028b---4</link>
            <guid isPermaLink="false">https://medium.com/p/478b24e6ff57</guid>
            <category><![CDATA[firestore]]></category>
            <category><![CDATA[go]]></category>
            <dc:creator><![CDATA[uo]]></dc:creator>
            <pubDate>Wed, 07 Dec 2022 02:56:03 GMT</pubDate>
            <atom:updated>2022-12-07T02:56:03.302Z</atom:updated>
            <content:encoded><![CDATA[<p>この記事は シェア買いアプリ「カウシェ」 Advent Calendar 2022 の7日目の記事です。</p><p><a href="https://adventar.org/calendars/7660">シェア買いアプリ「カウシェ」 Advent Calendar 2022 - Adventar</a></p><p>こんにちは。株式会社カウシェでバックエンドエンジニアをしている@uoです。</p><p>Google Cloud Next ‘22でFirestoreのCount機能が発表されました！</p><p><a href="https://cloud.google.com/blog/products/databases/unifying-expanding-optimizing-databases-next22">New advancements in Google Cloud databases | Google Cloud Blog</a></p><p><a href="https://medium.com/kauche/7deb17cb2795">以前書いた記事</a>のように今まではFirestoreでCountするには考慮することが多かったため、嬉しい機能になります！</p><p>カウシェではGo言語を採用しているのですが、Go言語では<a href="https://github.com/googleapis/google-cloud-go/releases/tag/firestore%2Fv1.8.0">cloud.google.com/go/firestore v1.8.0</a>からCount機能を使えるようになっています。</p><h3>これまでのカウント方法</h3><p>これまではFirestoreのドキュメント数をカウントする場合、対象のドキュメントを全て取得してクライアント側でカウントを行う必要がありました。</p><p>この方法には以下のような問題があります。</p><ul><li>データ件数が多い場合にデータの取得に時間がかかる</li><li>データの読み取りに料金がかかる</li></ul><p>カウシェではこれらの問題を回避するために事前にカウントをしてFirestoreに保存する、という方法を使っています。</p><p>ただ、事前にカウントする機能の実装が必要だったり、実際の件数とカウントした値のズレをどう防ぐか考慮する必要がある、といった手間がありました。</p><p>Countクエリはこれらの問題の解決策になり得るため、ずっと期待していた機能でした！</p><h3>Countクエリを使ってみる</h3><p>実際にCountクエリを使ってデータ件数を取得してみます。言語はGoを使っています。</p><p>Usersコレクションからアクティブなユーザーを取得する場合のコードは以下のようになります。</p><pre>func count(ctx context.Context, client *firestore.Client) error {<br>    q := client.Collection(&quot;Users&quot;).Where(&quot;Status&quot;, &quot;==&quot;, &quot;active&quot;)<br>    // firestore.Queryからfirestore.AggregationQueryを生成<br>    aq := q.NewAggregationQuery()<br>    // AggregationQueryのOperatorにCountを設定し、Aliasをつける<br>    aq := aq.WithCount(&quot;activeUserCount&quot;)<br>    // AggregationQueryを実行<br>    res, err := aq.Get(ctx)<br>    if err != nil {<br>        return err<br>    }<br><br>    // 結果を取得する<br>    count, ok := res[&quot;activeUserCount&quot;]<br>    if !ok {<br>        return fmt.Errorf(&quot;aggregation query key not found&quot;)<br>    }<br>    cv := count.(*pb.Value)<br>    fmt.Printf(&quot;Active User Count: %d&quot;, cv.GetIntegerValue())<br>    return nil<br>}</pre><ol><li>QueryからAggregationQueryを生成する</li><li>AggregationQueryのOperatorにCountを設定する</li><li>Getする</li></ol><p>これだけでデータ件数を取得することができます！</p><h4>FirestoreのAggregationについて</h4><p>Firestoreのprotoの定義を確認すると、1つのクエリに対してAggregationは最大5件設定できるようになっています。</p><pre>  // Optional. Series of aggregations to apply over the results of the `structured_query`.<br>  //<br>  // Requires:<br>  //<br>  // * A minimum of one and maximum of five aggregations per query.<br>  repeated Aggregation aggregations = 3 [(google.api.field_behavior) = OPTIONAL];</pre><p><a href="https://github.com/googleapis/googleapis/blob/master/google/firestore/v1/query.proto#LL421-L426">googleapis/query.proto at master · googleapis/googleapis</a></p><p>今はCountしか使えないですが、今後は1つのクエリに対してMaxやSumといった集約クエリを同時に実行することを想定していると考えられます。</p><p>期待が高まりますね！</p><h3>Countの料金</h3><p>Countの料金は、「一致したインデックス エントリの数」に対して課金されます。<br>インデックスエントリの一致が1000件で、1回のドキュメント読み込み相当の課金が行われます。</p><p>これまでは1000回のドキュメント読み込みが発生していたのが1回分の読み込みで済むので、コスト面でのCountの効果は大きいです。</p><h3>Countのパフォーマンス</h3><p>既存のカウント方法とCountクエリを利用した場合のデータの取得時間を調べてみました。<br>以下は10回カウントを取得した時の平均の取得時間です。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/44543145a18729f07c466d74dce55421/href">https://medium.com/media/44543145a18729f07c466d74dce55421/href</a></iframe><p>既存のカウント方法と比べるとパフォーマンスが大きく改善されています！<br>ただし、データ件数が増えると処理時間も増えるので、アプリから呼ばれるような同期的なAPIでCountクエリを使う場合には注意が必要になりそうです。</p><h3>最後に</h3><p>Firestoreに追加されたCountクエリについて調べてみました。<br>今までと比べると、簡単でコスト効率も良くカウントができるようになっています！</p><p>データ量が多く、パフォーマンスを考慮する必要がある場合は<a href="https://firebase.google.com/docs/firestore/solutions/counters">Distributed counters</a>を選択する必要があると思いますが、それ以外ならCountクエリが使えそうだと感じました。</p><p>まだPreview版の機能なので、GA版を楽しみに待ちたいと思います！</p><h3>カウシェでは、共に「世界一楽しいショッピング体験をつくる」メンバーを募集中</h3><p>少しでも気になった方は、ぜひ下記よりエントリーいただければと思います。</p><p><a href="https://enjoy-working.kauche.com/product">Product@KAUCHE</a></p><h3>参考</h3><ul><li><a href="https://cloud.google.com/blog/products/databases/aggregating-data-with-firestore?hl=en">https://cloud.google.com/blog/products/databases/aggregating-data-with-firestore</a></li><li><a href="https://firebase.google.com/docs/firestore/query-data/aggregation-queries">https://firebase.google.com/docs/firestore/query-data/aggregation-queries</a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/936/1*knwCX-sPKW6ze1cq3FFoqA.png" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=478b24e6ff57" width="1" height="1" alt=""><hr><p><a href="https://medium.com/kauche/go-firestore-count-478b24e6ff57">FirestoreのCountクエリでコストとパフォーマンスは改善できるのか</a> was originally published in <a href="https://medium.com/kauche">KAUCHE Tech Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>