# Webページの画像と原稿制作について

このページとはパソコンとスマートフォンで見比べてご覧ください。  
  
 ![](https://cont.sterfield.co.jp/uploads/qr_reference_materials_72c097b82b.png) 

スターフィールドでは、ECショップのシステムを提供しています。ご利用いただいているお客様から、画像や原稿の作成方法についてよくお問い合わせをいただきます。
お問い合わせ内容を見ると、スターフィールドのシステムに限定したものだけでなく、Webサイトに掲載する素材全般に共通するポイントが多いようです。  
  
そこで、普段Web制作をされていない方がWebサイト用の画像や原稿を作成される際に、気を付けたいポイントについてご紹介します。
  
## 画像サイズの説明
  
Webサイトで画像を作る際には、画面幅とコンテンツ幅の横幅を意識し、どのように掲載されるのかを考えていきます。
  
画面幅は文字通り、画面全体の表示領域です。  
現在ご覧になっているこの記事ページで言うのであれば、画面左上のスターフィールドのロゴから画面右上のメニューアイコンまでの幅を指します。
  
一方、コンテンツ幅はそのページの記事が表示されている領域です。  
このページで言うなら、この記事のテキストが掲載されているエリアとその横側についているボタン類迄です。スマートフォン版で見た場合はこのボタン類はテキストの下に配置されています。  
一般的に、パソコンのWebページでは、画面幅は1500px以上、コンテンツ幅は最大1,000px～1,200px程度で作成されます。このページのコンテンツ幅は最大1,100pxです。  

そのため、パソコンの画面の端から端まで大きく表示される画像は、1500px～2000px程度の大きさで作成されることが多く、コンテンツ幅内に表示される画像は640px以上で作成されることが多くなります。  
  
スターフィールドの業務に関しては、ECショップに関わることが多いです。  
ECショップでは、商品画像やその解説に関わる画像が最も多く使用されます。また、商品は一般的に、図1のように一覧ページと詳細ページに分けて表示され、一覧で商品をクリックすると詳細ページに移動されることが一般的です。
  
図1  
 ![](https://cont.sterfield.co.jp/uploads/sample_pc_fc38f80361.png) 

  
このように画面をレイアウトする場合、写真のサイズは、実際には640pxよりも小さくなります。
具体的には、一覧画面では200px～300px程度、詳細画面でも500px程度が一般的です。  
  
近年のWebサイトは、パソコンだけでなくスマートフォンでも閲覧されることを想定して作られるケースが増えています。そのため、パソコンでもスマートフォンでも快適に閲覧できるよう、画像のサイズを調整して作成することが多いのです。スターフィールドのシステムでも同様です。
  
では、ECショップを例にした場合、スマートフォンでは図2のようなレイアウトが多いと思います。
  
図2  
 ![](https://cont.sterfield.co.jp/uploads/sample_sp_9aebe8495f.png) 
  
パソコンと比べると、スマートフォンの画面は小さくなっています。また、多くのWebサイトでは、画面幅とコンテンツ幅が同じになっており、詳細ページでは、画面の端から端まで商品画像が表示されることが多くあります。そのため、スマートフォンの画面の端から端まで表示しても問題ないサイズの画像を用意する必要があるのです。

スマートフォンの画面サイズは機種によって異なりますが、端から端まで表示する場合は、640pxに設定されていることが多いようです。また、デジタル画像は拡大すると画質が落ちるものの、縮小すると画質が劣化しにくい性質があります。この性質を利用して、画像は640pxで作成し、必要に応じて縮小して表示する仕組みでWebサイトを作成することが多いです。

そのため、お客様から制作者側に提供する画像は、トップページなどの大きな画像を除き、コンテンツ内に表示させるものであれば、640px以上のサイズのものを提供いただくことで作成や更新がスムーズに進みます。

## 文字つきの画像データを作成する際の注意
  
画像の中に文字を入れる場合、画像のサイズが画面幅に応じて変化するため、文字のサイズも変化することに注意が必要です。
実際に図3をご覧ください。

  
図3  
 ![](https://cont.sterfield.co.jp/uploads/sample_1500_8193643d79.png) 

  
図3は、パソコンの画面幅に合わせて横幅1500pxで作成されています。このサイズは、パソコンの画面を端から端まで表示させることを想定しています。
  
しかし、このブログのテキストの表示領域は最大825pxなので、パソコンで見た場合は55%に縮小されて表示されてしまいます。スマートフォンで見た場合はさらに縮小されます。


このように、画像のサイズが画面幅に応じて変化すると、画像内に記載された文字も一緒に縮小されてしまいます。そのため、文字の視認性が著しく低下してしまいます。図3の画像内で一番小さい文字は、14ptで作成されていますが、縮小されたことで読みにくくなっていることが確認できます。
  
Webページのテキストは、一般的に14px～16pxのサイズで作成されます。ptとpxは異なる単位ですが、14ptは約18px相当になります。そのため、文字を読みやすくするためには、14pt以上の大きさで作成することを意識しましょう。
  
また、パソコンの画面幅に合わせて画像を作成すると、スマートフォンではさらに文字の視認性が悪くなります。そのため、このような大きな画像については、図4のようにスマートフォン版専用の画像を用意して、パソコンとスマートフォンで異なる画像を表示するように設定します。

図4    
 ![](https://cont.sterfield.co.jp/uploads/sapmle_640_b27b695332.png) 

  
ネットショップの場合、商品画像に「新発売」などの数文字のフレーズを入れる分には、さほど問題になるケースは少ないでしょう。しかし、商品の説明について、成分の解説や商品ができるまでの過程をグラフィカルにまとめた資料をお客様が作成する場合は、注意が必要です。
  
画面幅に応じて画像のサイズも変化し、記載されている文字も合わせてサイズが変化することを想定せずに画像を作成すると、パソコンやスマートフォンで文字が読みにくくなる傾向にあります。また、デザインによっては、パソコン版とスマートフォン版で別々の画像を作成する必要があり、手間が増えることもあります。
  
## テキストについて
  
お客様から寄せられるお問い合わせの中には、テキストに関するご質問や修正依頼もあります。
  
Webページのテキストサイズは、一般的に14px～16pxを基準に設定します。デザインを行う際は、このサイズでテキストを作成して、テキスト量と画像バランスを考慮してデザインします。 
  
しかし、画像サイズは閲覧する端末によって変化するため、Webページとして実際に表示した際に、想定したバランスが崩れてしまいやすいです。特に、普段、紙媒体のデザインを手がける方々からは、この点に関する指摘が多く寄せられます。
  
よく依頼される指摘の一例として、文字の改行に関するものがあります。しかし、テキストは画像とは異なり、制作者が完璧にコントロールすることが難しいため、意図しない改行が発生することがあります。
  
ディスプレイ性能やOS、ブラウザ、閲覧者の端末の設定などによって、文字サイズや文字間、行間などに微小な差異が生じます。これらの要因が重なり、制作者が意図しない改行に繋がります。
  
そのため、例えば、制作者の開発環境で最適に見えるように調整しても、別の環境で閲覧したら意図しない改行が生ずることがあります。
  
このように、Webページのテキストは、制作者の意図した通りに表示されない可能性があることを前提として、テキストと画像の配分はある程度ずれること、細かな改行指定はしない、などのことを想定して原稿を作る必要があります。
  
## まとめ
Webページは、実際に作ってみないと分からないことがたくさんあります。そのため、制作者も依頼者も、想定外のことが起こることがあります。

そのようなことが起こった場合は、ぜひご相談ください。ご要望をお聞きし、最適な解決策をご提案します。

25286080_s.jpg

Webページの画像と原稿制作について

## はじめに
先日、基本情報技術者試験の受験をしてきましたので、後に続く人に有益な情報を残すため、<br>
本記事では、基本情報技術者試験の攻略方法についてをまとめたいと思います。

## 基本情報技術者試験の実施概要
基本情報技術者試験には、午前中に実施する「科目A 試験」と、午後に実施する「科目B 試験」があります。制限時間や問題数などについては、以下のようになります。<br>
 ![](https://cont.sterfield.co.jp/uploads/2024_01_05_13_10_54_6d03b4b0e6.png) 
試験は、CBT方式で行います。(テストセンターでPCパチパチするやつです)<br>
### 科目A 試験の概要
「科目A 試験」は出題数が全部で60問あり、四肢択一式です。<br>
情報処理分野（テクノロジ系）、マネジメント分野（マネジメント系）、経営・会計分野（ストラテジ系）から出題されます。<br>
プログラミングに関する部分だけではなく、マネジメントや経営など、幅広く勉強しなくてはなりません。<br>
 ![](https://cont.sterfield.co.jp/uploads/2024_01_05_13_12_45_1b7095f228.png) 
### 科目B 試験の概要
「科目B 試験」は、多肢選択の長文読解式で20問出題されます。出題分野は、「アルゴリズムとプログラミング」と「情報セキュリティ」となり、以下のカテゴリで構成されています。<br>
- プログラミング全般（既存プログラムの解読及び変更やプログラムのテストなど）
- プログラムの処理の基本要素（型や変数など）
- データ構造及びアルゴリズム（グラフや整列など）
- プログラミングの諸分野への適用（数理やデータサイエンスなど）
- 情報セキュリティの確保（脆弱性管理バックアップなど）

## 試験の内容
*の数で重要度が表現されています。
### 1.コンピュータ構成要素
- [情報の表現](https://tamotech.blog/2022/10/16/amount-of-information/)**<br>
- [コンピュータの構成](https://tamotech.blog/2022/10/16/computer/)<br>
- [CPU](https://tamotech.blog/2022/10/22/cpu/)<br>
- [CPUの動作原理](https://tamotech.blog/2022/11/12/addressing-method/)<br>
- [CPUの高速化技術](https://tamotech.blog/2022/11/12/cpu-pipline/)<br>
- [半導体メモリ](https://tamotech.blog/2022/11/17/rom-ram/)*<br>
- [補助記憶装置](https://tamotech.blog/2022/11/26/auxiliary-storage/)<br>
- 入出力装置<br>
- [入出力インターフェース](https://tamotech.blog/2022/11/27/input-output-interface/)<br>

### 2.ソフトウェアとマルチメディア
- ソフトウェア*<br>
- [ジョブ管理とタスク管理](https://www.youtube.com/watch?v=CPCZ8hgtPl0)*<br>
- 記憶管理*<br>
- ファイル管理*<br>
- [マルチメディア](https://www.johoka.jp/digital#h.9uo4whoso8hx)<br>

### 3.基礎理論
- 基数変換**<br>
- 補数と固定小数点<br>
- [浮動小数点](https://tamotech.blog/2023/05/02/%e3%80%90ieee754%e3%80%91%e6%b5%ae%e5%8b%95%e5%b0%8f%e6%95%b0%e7%82%b9%e3%81%ae%e8%a1%a8%e7%8f%be%e8%a6%8f%e6%a0%bc%e3%81%a8%e3%81%9d%e3%81%ae%e5%a4%89%e6%8f%9b%e6%96%b9%e6%b3%95/)<br>
- 誤差<br>
- シフト演算*<br>
- 論理演算**<br>
- 半加算器と全加算器<br>
- [計測と制御](https://www.johoka.jp/digital)**<br>
- オートマトン*<br>
- AI**<br>
- 線形代数*<br>
- 確率統計**<br>

### 4.アルゴリズムとプログラミング(B)
- アルゴリズム**<br>
- 配列**<br>
- リスト*<br>
- キューとスタック**<br>
- 木構造*<br>
- データの整列*<br>
- データの探索*<br>
- アルゴリズムの計算量<br>
- プログラムの属性*<br>
- プログラム言語とマークアップ言語*<br>

### 5.システム構成要素
- [システム構成](https://tamotech.blog/2022/12/04/system-configuration/)*<br>
- [クライアントサーバシステム](https://tamotech.blog/2022/12/12/crient-server-system/)*<br>
- [RAIDと信頼性設計](https://tamotech.blog/2022/12/30/raid-level/)*<br>
- システムの信頼性設計*<br>
- システムの信頼性評価**<br>

### 6.データベース技術
- データベース*<br>
- データベース設計*<br>
- データの正規化*<br>
- [トランザクション処理](https://tamotech.blog/2023/01/14/data-transaction-consistency/)**<br>
- [データベースの障害回復](https://tamotech.blog/2023/01/15/roll-forward-and-roll-back/)*<br>
- データ操作とSQL**<br>
- SQL(並べ替え・グループ化)*<br>
- SQL(副問合せ)<br>
- [データベースの応用](https://tamotech.blog/2023/01/28/nosql/)*<br>

### 7.ネットワーク技術
- [ネットワーク方式](https://www.foresight.jp/fe/column/lan-wan/)*<br>
- [通信プロトコル](https://zenn.dev/itpassport/articles/03bd090fa135ba)*<br>
- [ネットワーク接続機器](https://qiita.com/pieceofmysoul1225/items/fb42aeceb0b423e1895d)**<br>
- [IPアドレス](https://zenn.dev/itpassport/articles/acefa57f6d2b76)**<br>
- [IPアドレスのクラス](https://qiita.com/pieceofmysoul1225/items/b75f5d00ca40de49b8b8)**<br>
- [ネットワーク管理とインターネットの応用](https://qiita.com/pieceofmysoul1225/items/143c3c743bca15d65625)*<br>

### 8.情報セキュリティ(B)
- 情報セキュリティと情報セキュリティ管理**<br>
- 脅威とマルウェア**<br>
- サイバー攻撃**<br>
- 暗号化技術**<br>
- 認証技術**<br>
- 利用者認証とネットワークセキュリティ**<br>

### 9.システム開発技術
- 情報システム戦略とシステム企画*<br>
- ソフトウェア開発**<br>
- オブジェクト指向**<br>
- 業務モデリング*<br>
- ヒューマンインターフェース*<br>
- モジュール分割<br>
- テスト手法*<br>

### 10.マネジメント系
- プロジェクトマネジメント*<br>
- 工程管理*<br>
- ITサービスマネジメント*<br>
- システム監査**<br>

### 11.ストラテジ系
- ソリューションビジネスとシステム活用促進**<br>
- 経営組織と経営マーケティング戦略*<br>
- 業績評価と経営管理システム<br>
- 技術開発戦略<br>
- ビジネスインダストリ**<br>
- 品質管理<br>
- 会計財務*<br>
- 知的財産権とセキュリティ関連法規**<br>
- 労働・取引関連法規と標準化*<br>
- オペレーションズリサーチ<br>

※ youtubeで解説してくれている人がいたので、何かわからない事があれば見てください<br>
https://www.youtube.com/@kihonzyouhou/videos

## 攻略方法について
### 基礎的なIT知識をおさえる
基本情報技術者試験の勉強を効果的にするには、まず基礎的なIT知識をおさえましょう。<br>
基礎的なIT知識が身についていなければ、先に進んでも理解が深まりません。<br>
はじめて基本情報技術者試験の勉強をする人は、テキストを何度も読み、用語の意味を理解して、基礎をしっかり身につけましょう。テキストを読むごとに、基礎知識は定着していきます。<br>

### 過去問題を繰り返し解く
基本情報技術者試験の勉強は、過去問題を繰り返し解くことも大切です。<br>
「科目A 試験」の勉強には、変更前の午前試験の過去問題を活用できるため、繰り返し解いて試験対策をしましょう。<br>
できるだけ多くの過去問題を解くことで有利になります。<br>
過去に何度も繰り返し出題されている問題は、重要な問題であることが多いため試験対策に活かしましょう。<br>

「基本情報技術者過去問道場」の活用<br>
https://www.fe-siken.com/fekakomon.php<br>
解説も出てくるので、理解しやすい！<br>

## まとめ
50~100時間くらい勉強時間を確保しましょう。<br>
あとは、集中するだけです。<br>

ちょっと難しいなと思う人は、難易度の低い「ITパスポート試験」を受験してみてもいいかもしれません。<br>

9784297131302.jpg

【基本情報技術者試験】効率的な攻略方法について

## はじめに

2023 年には、CSS にいくつかの新しい機能が追加されましたので　このブログでは、2023年の新しいCSSの機能について紹介したいと思います。

最新のCSS技術や仕様は、ウェブページが早く読み込まれ、表示される速さや効率を良くすることを目指しています。

新しいCSSの機能やツールは、開発者がコードをより効果的に書き、管理するのに役立ちます。

Web 開発者は、より個性的で魅力的な Web ページを作成できるようになります。
すべてのブラウザでサポートされているわけではありません。ただし、ほとんどの主要なブラウザでは、これらの機能がサポートされています。

今回以下の新しい　CSS について説明します。

1. inset
2. Accent-color
3. Gap Property for Flexbox
4. -webkit-line-clamp
5. Small Viewport Units(svh)
6. Transform Properties

## 1. inset

CSS insetは、要素をその親要素の端に対して配置するためのプロパティです。通常の配置ではなく、要素が親要素からはみ出るようなデザインを作成する際に便利です。

**前**
```
element {
  top: 80%;
  right: auto;
  bottom: auto;
  left: 50%;
}
```
このコードはtop、right、bottom、left の各プロパティを個別に指定しています。

**現時**
```
element {
  inset: 80% auto auto 50%;
}
```
現時は inset プロパティを 使て　1 行で指定できるようになりました。

**Browser Support**

 ![](https://cont.sterfield.co.jp/uploads/inset_browser_support_69d35a4768.png) 


## 2. accent-color

accent-colorプロパティとは、ラウザが提供するデフォルトのフォーム要素（チェックボックスとラジオボタンとか）の背景色を変更することができるものです。ただし、このプロパティを使用すると、フォームの見た目はブラウザによって統一的に管理されるため、その点に注意が必要です。accent-colorは、2023年からすべてのブラウザにサポートされました。


**html**
```
<input type="checkbox" class="custom" checked />Checkbox
```

**css**
```
.custom{
  accent-color: yellow;
}
```

***Result***

 ![](https://cont.sterfield.co.jp/uploads/checkbox_result_c9839aff27.png) 

**Browser Support**

 ![](https://cont.sterfield.co.jp/uploads/accent_color_browser_support_4483e6b598.png) 


## 3. Gap Property for Flexbox

Gap プロパティは、flexbox レイアウトで各アイテムの余白を指定するプロパティです。
余白を指定すると　margin も使う人が多いですが、gap と　margin の違いがあります。

**Gap**
* flexbox レイアウトでのみ使用できます。
* 単一の値または 2 つの値で指定できます。
  ```
  gap: 10px;/* 行と列の両方に同じギャップ */
  gap: 10px 20px;/* 行に10px、列に20pxの異なるギャップ */
  ```
* 余白を指定すると、最初と最後の要素余白も範囲されません。
  :not()や:nth-childなどの擬似クラスを使用する必要がなく、CSSのコードがシンプルになります。

**Margin**
* 任意のレイアウトで使用できます。
* 単一の値、2 つの値、または 4 つの値で指定できます。
  ```
  margin: 10px;/* すべての辺に同じマージン */
  margin: 10px 20px;/* 上下には10pxのマージン、左右には20pxのマージン */
  margin: 10px 20px 15px 5px;/* 上、右、下、左それぞれ異なるマージン */
  ```
* 余白を指定すると、最初と最後の余白も範囲されます。

**html**
```
<div class="flexbox">
  <div class="flex-item">div1</div>
  <div class="flex-item">div2</div>
  <div class="flex-item">div3</div>
  <div class="flex-item">div4</div>
  <div class="flex-item">div5</div>
  <div class="flex-item">div6</div>
  <div class="flex-item">div7</div>
  <div class="flex-item">div8</div>
  <div class="flex-item">div9</div>
</div>
```

**css**
```
.flexbox {
  display: flex;
  gap: 10px;
  width: 500px;
  flex-wrap: wrap;
  justify-content: center;
}
.flex-item{
  background: yellow;
  width: 30%;
  color: #000;
  padding: 10px 0;
  text-align: center;
}
```

**Result**

 ![](https://cont.sterfield.co.jp/uploads/gap_image_ee5a78ad50.png) 

**Browser Support**

 ![](https://cont.sterfield.co.jp/uploads/gap_browser_support_c840b87e6a.png) 

## 4. -webkit-line-clamp

-webkit-line-clamp は、CSS の属性で、テキストの表示行数を決める機能です。この機能を使うと、テキストの折り返しを管理して、簡潔で読みやすいテキストブロックを作成することができます。

**html**
```
<p class="truncate-text">
    This is a long piece of text that will be truncated after three lines using the -webkit-line-clamp property. This is a long piece of text that will be truncated after three lines using the -webkit-line-clamp property.
</p>
```

**css**
```
.truncate-text {
  display: -webkit-box;
  -webkit-box-orient: vertical;
  overflow: hidden;
  -webkit-line-clamp: 3; 
  width: 200px;
}
```

**Result**

 ![](https://cont.sterfield.co.jp/uploads/webkit_line_clamp_result_b8921f908a.png) 

**Browser Support**

 ![](https://cont.sterfield.co.jp/uploads/line_clamp_browser_support_7a35bf934f.png) 


## 5. Small Viewport Units(svh)

Small Viewport Units (svh)は、ユーザーに表示される最小のビューポートの高さを表す単位です。最小のビューポートの高さは、ユーザーエージェントによってすべてのインターフェース要素が除外されます。
要素の高さを簡単に調整できます。アドレスバーが含まれるため、要素の実際の高さが異なることもあります。

**html**
```
<div id="container">
  <label>Top Full Height Example(svh)</label>
  <p>Bottom Full Height Example(svh)</p>   
</div>
```

**css**
```
#container {
  background-color: green;
  height: 100svh; 
  position: relative;
}
p{
  position: absolute;
  bottom: 0;
}
label{
  position: absolute;
  top: 0;
}
```
上記の　コード によると　divの高さを 100svh としているので　モバイルの場合アドレスバーの上に表示するようになりました。

div　の　高さを 100vh とすると　下のテキスト(Bottom Full Height Example(svh))が見えなくなります。

**Result**

 ![](https://cont.sterfield.co.jp/uploads/svh_7979a9aefa.png) 

**Browser Support**

 ![](https://cont.sterfield.co.jp/uploads/svh_browser_support_f32c6b0d96.png) 


## 6. Transform Properties

CSS の transform プロパティは、要素の位置、回転、スケール、傾きなどを変更するために使用されます。

**前**
```
.target {
  transform: translateX(50%);
  transform: rotate(50deg);
  transform: scale(1.5);
}
```
このコードは、3 行にわたって、translateX()、rotate()、scale() の各関数を指定しています。

**現時**
```
.target {
  transform: translateX(50%) rotate(50deg) scale(1.5);
}
```
このコードは、1 行だけで、translateX()、rotate()、scale() の各関数を指定出来るようになりました。

**Browser Support**

 ![](https://cont.sterfield.co.jp/uploads/individual_transfrom_browser_support_4f7d36d0a1.png) 


## まとめ

将来、新しいCSSの機能がますます広くサポートされることで、開発者は安定してこれらの機能を活用できるようになります。
新しい機能を使うと、開発者はもっと効率的に作業できて、コードを書くことがスムーズになるでしょう。

日々のプロジェクト開発において、新しいCSSを取り入れて活かしていきたいです。

ただし、新しいCSS機能を利用する前に、ご希望の機能がブラウザでサポートされているか確認するために、このリンク（https://caniuse.com/ ）から確認してください。

## 参考

* https://www.w3.org/Style/CSS/all-properties.en.html
* https://developer.mozilla.org/ja/docs/Web/CSS


2023 年の新しい CSS 機能

## はじめに
先日、東京ビッグサイトで開催されたGoogle Cloud Next Tokyo '23のDay2に参加してきました。

 ![](/uploads/PXL_20231116_001744341_2_90d59a9df4.jpg) 

全体としては生成AIに関するトピックが盛り上がってましたが、セキュリティに関するセッションもいくつかあり、その中で私は下記のセッションに参加して話を聞いてきました。

- [セルフで行う Google Cloud 環境のセキュリティ チェックの方法](https://cloudonair.withgoogle.com/events/next-tokyo?talk=d2-di-04)
- [Google Cloud のセキュリティ機能、基本のキ｜Security Command Center で実現するリスク管理](https://cloudonair.withgoogle.com/events/next-tokyo?talk=d2-sec-02)

どちらのセッションでもSecurity Command Centerを使うことでGoogle Cloudを安全に運用できるという内容でした。
こちらをもとに本記事では、Google Cloudを利用しているがSecurity Command Centerは使ったことがない人向けに、Security Command Centerを使い始めるための設定方法と簡単な使い方の解説します。

## Security Command Centerとは
Security Command CenterはGoogle Cloud上の脆弱性や脅威となりうる設定を検知してくれるサービスです。

有効化しておくと自動で利用しているサービス、リソースを認識して、それらを対象に設定内容をスキャンしてくれるため運用に負荷がかからないのが特長です。また有償版のプレミアムティアーのみの機能となりますが、ISO 27001やPCI DSSのような業界標準への遵守状況も確認できるなどスキャン以外にも様々な機能があります。

今回は無償版のスタンダードティアーでも利用可能なSecurity Health Analytics機能を使って、Google Cloudの設定ミスの診断を試してみました。

## 実際に適用してみた結果
ありがちなユースケースとして、組織の管理権限はもってないが開発環境のプロジェクトだけ変更権限だけを持つユーザーが、Security Command Centerを使ってプロジェクトの脆弱性を診断してみるというシナリオでやってみました。

1. Security Command Centerの有効化
  - まず最初にコンソールでプロジェクトを選択した状態でSecurity Command Centerを開いて有効化を行います。スタンダードとプレミアムの2つのティアーを選択する画面になるので、無償版であるスタンダードを選んで次へを押します。すると、どの機能を有効化するか設定するダイアログが表示されます。すべてデフォルト値のままで進めます。

     ![](/uploads/249ce2bfaa98636550da620a_d3f7f1273a.png) 
      (引用：https://zenn.dev/cloud_ace/articles/scc_standard#security-command-center(%E3%82%B9%E3%82%BF%E3%83%B3%E3%83%80%E3%83%BC%E3%83%89)%E3%82%92%E6%9C%89%E5%8A%B9%E3%81%AB%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B)

  - 詳細な手順は公式ドキュメントで解説されているのでそちらを参照してください。
  https://cloud.google.com/security-command-center/docs/activate-scc-for-a-project?hl=ja#project-activation-scc-inactive-in-org

2. 診断結果の確認
  - 設定が完了すると自動で脆弱性のスキャンが行われますが、初回のスキャンは少し時間がかかります。今回の例だと24時間ほど待つ必要がありました。
  - 完了するとダッシュボードにスキャン結果が表示されます。脆弱性ページで脆弱性の種類、件数などが確認できます。

     ![](/uploads/scc_1_762224c8e4.png) 
    

3. 脆弱性の対応
  - ここではデフォルトのまま使っていると必ず検出されるOpen RDP portを対象として、実際に対応する場合の流れを解説します。

  - 詳細を開くと脆弱性の詳細や、対象のリソースの情報が確認できます。更に次のステップのところに対応方法が示されます。
    ![](/uploads/scc_2_0a09b3e035.png) 

  - それに従って、ファイアウォール ルールのdefault-allow-rdpの設定を変更します。IPの範囲が0.0.0.0/0がまずいとのことなので削除して35.235.240.0/20を設定します。
     ![](/uploads/scc_3_4f9c670868.png) 

  - なお、ルール自体を無効にしてしまえばIP範囲は変更しなくてよさそうに思えますが、この対応ではだめでした。脆弱性の判断基準としてルールが無効かどうかは関係ないようです。現時点で実害があるかどうかではなく、潜在的な脆弱性として指摘しておくポリシーなのかもしれません。

4. 対応結果の確認
  - 初回スキャンと同様に対応後の確認も特に操作は不要で、自動で再チェックが行われて脆弱性ページの件数が1=>0になります。初回スキャン時と異なり、設定変更後の再スキャンはほぼ即時反映のようで数分後には対応済みになりました。
  - 対応済みの脆弱性を確認したい場合、脆弱性ページ上からは見られなくなってしまいますが、検出結果ページのクエリ編集画面で下記のとおりクエリを変更すると確認可能になります。
    ```
    変更前）
    state="ACTIVE" AND NOT mute="MUTED"

    変更後）
    state="INACTIVE" AND NOT mute="MUTED"
    ```
     ![](/uploads/scc_4_19e81badad.png) 

## まとめ
- Security Command Centerは有効化するだけで特に設定も不要かつ無料で始められるので、使ってみることをおすすめします。
- 検出された脆弱性ごとの対応方法まで案内されるので非常に親切だが、今すぐ対応すべき問題かどうかは利用者自身が判断する必要があります。そのため、まったく知識がない状態で運用することは難しそうです。これについてはGoogle側でも課題と考えているようで、Duet AIによる支援機能が現在開発中とのことです。
- 組織単位でSecurity Command Centerの有効化を行うことで、アカウントの設定不備のようなプロジェクトをまたがった設定内容もスキャン対象となるため、より効果的な運用ができそうです。今回の検証結果をもとに、全社的にSecurity Command Centerを利用する方針を検討していきます。

## 参考リンク
- [Security Command Center](https://cloud.google.com/security-command-center?hl=ja)
- [Security Command Center でお手軽セキュリティ診断](https://zenn.dev/cloud_ace/articles/scc_standard)
- [[Google Cloud] SCC -Security Health Analytics-を試す](https://qiita.com/khoshina/items/f6ccea548e9ed39cdea8)


security-command-center.440x512.png

Security Command Centerを使ってGoogle Cloudの設定内容を診断してみよう

### 書籍の情報
- 書籍名: TypeScriptとReact/Next.jsでつくる実践Webアプリケーション開発
- 著者: 手島拓也、吉田健人、高林佳稀
- 出版社: 技術評論社
- ISBN-13: 978-4297129163
- 発行日: 2022/7/25
- リンク: https://gihyo.jp/book/2022/978-4-297-12916-3

## はじめに
「TypeScriptとReact/Next.jsでつくる実践Webアプリケーション開発」は、開発をより快適・堅牢にするTypeScriptを用いて、React/Next.jsの基礎、最新フロントエンドやWebアプリケーションの開発方法が学べる書籍です。

TypeScriptは、JavaScriptのスーパーセットであり、型システムを備えたプログラミング言語です。型による静的チェックにより、プログラムの欠陥をコンパイル時やデバッグ時に検出することができます。これにより、バグの早期発見や、コードの保守性の向上につながります。TypeScriptはWebアプリケーション、Node.jsアプリケーション、モバイルアプリケーションなどのさまざまなプラットフォームで利用されており、特に大規模で複雑なプロジェクトの開発に適しています。開発者が型安全なコードを書くのを支援し、コードの保守性を向上させるために広く採用されています。

Next.jsは、フルスタックのWebアプリケーションを構築するためのReactフレームワークです。設定に時間を費やすことなく、アプリケーションの構築に集中することができるよう設計されています。Next.jsは、Reactアプリケーションを開発するためのツールセットやサーバーサイドレンダリング（SSR）および静的サイト生成（SSG）の機能を提供し、それらの機能により、SEOの向上、パフォーマンスの向上、セキュリティの向上など、多くの利点を提供します。従って、多くのウェブ開発者によって採用され、高品質のウェブアプリケーションの開発に役立っています。

## こんな方におすすめ

- モダンなWebフロントエンドに興味のある方
- React/Next.jsを初めて使う方、本番に導入したい方
- React/Next.jsとTypeScriptを組み合わせた開発スタイルに興味のある方
- TypeScriptを中心に据えたWebフロントエンド開発に興味のある方
- Atomic DesignやStorybookなど、コンポーネント中心の開発に興味のある方

## 目次

1. Next.jsとTypeScriptによるモダン開発
2. TypeScriptの基礎
3. React/Next.jsの基礎
4. コンポーネント開発
5. アプリケーション開発1〜設計・環境設定〜
6. アプリケーション開発2〜実装〜
7. アプリケーション開発3〜リリースと改善〜
- Appendix Next.jsのさらなる活用

## 各章について

### 1~3章

1章では、Next.jsやTypeScriptを使用したモダンなフロントエンド開発の概要と歴史を紹介しています。歴史の説名を踏まえ、Next.jsの機能に絡めてSSRやSSGの紹介やその必要性に関する説明もされています。

2章では、TypeScriptの基本的な使い方や重要な型について説明されています。また、設定やツールのセットアップについても触れられています。

3章では、Reactの基本的なコンポーネントやフックの書き方やNext.jsの機能の使い方が紹介され、再レンダリングの防止など重要なポイントもカバーされています。

### 4章

この章ではデザインシステムの設計方法であるAtomic Designが紹介され、ReactコンポーネントもAtoms, Molecules, Organisms, Templates, Pagesの5レイヤーに分類することが推奨されています。Atomic Designとあわせて、ファイル分割やコンポーネント設計の参考になるPresentational Component（見た目）とContainer Component（振る舞いロジック）についても説明されました。
あと、styled-componentsスタイルライブラリから、Storybookでのコンポーネント管理、React Testing Libraryでのコンポーネントテストまで、コンポーネント開発のために使われる一連のツールの使い方が説明されています。

### 5~7章、付録

後半からはアプリケーション開発の実践になります。

5章では主にアプリケーション開発に向けての環境構築を行います。Next.jsや前の章で説明があったstyled-components、StorybookとESLintのセットアップとReact Hook Formをはじめ、SWRとMaterial Icons、React Content Loaderなどさまざまなライブラリやツールの導入が紹介されます。

6章は、総435ページで150ページほど占めて本のメイン部分ですが、ほぼコードに構成されていて間に簡単な説明が入ります。まずは、Atomic Designに従って各ページをコンポーネントコンポーネントへと分割して、一番小さい部品であるAtomsから実装していきます。次のMolecules実装も特にロジックを持たないようにしています。Organisms, Templates, Pagesについても同様の構成で進みます。Pagesからは4章にあったPresentational ComponentとContainer Componentの見た目とロジックを別ファイルに分ける方法で実装していきます。加えて、React Testing LibraryでAtoms, Molecules, Organismsレイヤーのユニットテストを書きます。

7章では、まず、5章と6章でつくったアプリケーションをVercel, Heroku, Logflareといったサービスにデプロイする方法の説明されており実際にデプロイして見るのができます。また、SEO対策として、構造化データをページに付与する方法やOGP、sitemap.xmlの生成などを取り扱います。さらに、アクセシビリティ、XSSとかCSRFのセキュリティの説明もされています。

付録には外部サービスの連携活用など、さまざまな内容が説明されています。これらの内容は現場にも役立ち、読者にとって嬉しい情報となっています。

## 感想

既に探り探りでTypeScriptとReact/Next.jsで開発していましたが、本書を読んでから、TypeScriptとReact/Next.jsの組み合わせでの開発経験が浅い私にとっては、良い見本になりました。

本書は、全般的にわかりやすく、実践的な内容で、概観を掴めることができて満足しています。
また、さまざまなライブラリを取り入れて使用できてみたのも、良い点でした。例えば、Next.jsと同じチームで作られているデータ取得のためのReact HooksライブラリであるSWRやローディングを表示するライブラリReact Content Loaderは初めて使用してみて今後の開発にも良い選択肢になると思いました。

ただ、もうちょっと具体的な説明や使う理由などがあったらよかったなと思った部分もありました。例えば、ライブラリの使い方の説明では、なぜそのライブラリを使うのか、そのライブラリのメリットやデメリットなどについて、もう少し詳しく説明があると、理解しやすかったでしょう。

とはいえ、本書は、TypeScriptとReact/Next.jsの両方を学びたい人にとって、最適な入門書であることは間違いありません。本書を参考にして、TypeScriptとReact/Next.jsの開発スキルを磨き、実践で役立てていきます。

以上、『TypeScriptとReact/Next.jsでつくる実践Webアプリケーション開発』についての紹介でした。もし、TypeScriptとReact/Next.jsの組み合わせで実際動かしてみながら学びたい方には、ぜひおすすめの一冊です！

TypeScriptとReact/Next.jsでつくる実践Webアプリケーション開発

book.png

【書籍紹介】TypeScriptとReact/Next.jsでつくる実践Webアプリケーション開発

先日、弊社で運営しているコンペナビで、「自治体向け動画コンテスト主催サポートプラン」というLPを作成し公開しました。  
  
<a href="https://compe.sterfield.jp/lp_jichitai" target="_blank">コンペナビ　自治体向け動画コンテスト主催サポート</a>  

私はこのLP制作につき、デザイナーとコーディングを担当し作成しました。  

この案件は弊社の社内案件であり、若手の営業担当がディレクションを行い、私が制作という関係で進めました。

最終的に納得のいく物が作成できましたが、振り返ってみると、企画段階でもっと詰めるべきことがあったし、ディレクターと作業者の間でどこまでが自分が主導して進めるべきか？を悩み、時にはお互いに担当分野を越境したような動きがありました。  

また、社内の関係者間でも、相談するべき点がありました。  
この案件を通して、改めてディレクションの大切さを実感し、反省を兼ねてブログに残します。


## プロジェクトのスタート

当初私のもとには図1の形でまとめられたワイヤーを渡されました。  

図1
<img src="/uploads/20231020_1_16304a854a.png" alt="企画書第一段階">

ワイヤーのコンテンツを大まかなに分けると以下の内容となっていました。  

第1要素　（メインビジュアル要素）
・キャッチコピー
・コンペナビの強み（3点）
・メインビジュアル
・お問い合わせへのリンク

第2要素　
・動画コンテストを開催する意義とサポートする旨の文章
・具体的なサポート内容を示すアイコン

第3要素　
・コンペナビの強み５点を強調する旨のコンテンツ

第4要素　
・コンペ開催のフローと料金について（コンペナビの内容のコピー）

第5要素
・実績

第6要素（最下部）
・お問い合わせフォーム


そして、  
・デザインはコンペナビと関連ある物。コンペナビの下層ページのようなイメージでコンペナビのコンテンツだとわかるものにしてほしい。  
・コンテンツの内容はワイヤーの内容にしたい。  
・この案で上長からGoサインが出ているから進めてもらいたい  

という話をいただきました。  

率直に私が思ったことはまだ、ワイヤーとして完成していないと感じました。 そこで先ず私はディレクターと話し、コンテンツを整理しなおしました。

私は主に  
・メインビジュアルに要素を詰め込みすぎ。  
・メインビジュアルのコンペナビの強み（3点）もこれだけで1つのコンテンツとして成立するし、補足的に見せる内容ではない。  
・全体的にテキストが多い。ビジュアルで見せる部分とテキストで説明する部分を意識した方が良い。  
・第3要素のコンペナビの強みもリズミカルに見せるなら3つくらいに絞った方がよい。  
・補足したい説明があれば、よくある質問というコンテンツにしてQ＆A方式で解説すれば見栄えもよい。  

と言う点を指摘しました。  

そこで、私とディレクターの間でワイヤーを作り直す作業が始まりました。  
このやり取りはプロジェクトを進める上で別に間違ってはいなかったでしょう。  
ただ、デザイナーの私がどこまで口を出すべきか悩みました。  


### 反省点：  
・デザイナーに話を持っていく前に、もっと詰めるべき点があったのでは？  
・制作部としては私がデザイン作業をしていると思っていた。役割を明確にするべきだった。  



## ワイヤー完成からデザイン完成迄

私はワイヤーの内容を大まかにレイアウトし、画面の構成を作る作業をしました。まだ、コンテンツについて考える余地もあり、
なるべくビジュアル要素を増やしてテキスト量を減らすこと、言い回しや見せ方を工夫することで省略できる点はないか、
コンテンツの順番を変えることでよりインパクトが出る見せ方にならないか？などの点を工夫して作成をしました。  


そして、何か思いつけば図2のように実際に簡易的なサンプルを作って、ディレクターに提案するという流れで作業を進めました。
こうして同意を得て、細部まで含めて作成する作業に入りました。  

図2
<img src="/uploads/20231010_2_7c3fe1e73b.png" alt="気可食第一段階">



このとき、デザインはコンペナビを踏襲してほしいという要望を聞いていたので、コンペナビの色使いやアイコンの使い方を見てそれに
よせる作業をし図3の形でまとめました。  


図3
<img src="/uploads/20231020_3_5982681709.png" alt="図3">

そして、私及びディレクター双方が納得し、コーディング開始の段階になりましたが、この段階で上長に確認をいただきました。 
  
この時頂いた意見は、    
・実績をもっと前面に打ち出す形の方がいい。  
・コンペナビの強みという点が取ってつけたように見える。  
・動画コンテストを開く意義について言っているコンテンツが少ない。  
  
というものでした。 

私は当初のワイヤーがテキストが多く、すっきり見せることを意識していた。しかし、この意識を強くしたため、必要であった要素を作業の過程で削っていました。
結果、このデザイン案は作り直しとなったのですが、相談するべきタイミングは明らかに間違えてしまいました。


### 反省点：
・作業を進める段階で完成像の指針がぶれてしまった。  
・部署内で相談するべきタイミングをもっと増やすべきだった。  


## 仕切り直しから完成まで

結局案件は、ディレクター側で再度ワイヤーから作り直すという話になり、2週間くらい経過したらディレクターから新しいワイヤー（図4）が渡されました。
ほぼ、最終系に近い形でいただきました。  

図4
<img src="/uploads/20231020_4_4c7ec1839f.png" alt="図4">

そして、ディレクターが参考にしたWebサイトのURLと一緒に渡され、この形で作り細部はコーディングをしながら直してほしい。
と言われてコーディング作業開始に至りました。  

ここまで完成されたものを渡されたら、デザイナー側でビジュアル要素を作る作業はほぼありませんでした。ただ、これをコーダー目線で見た場合、設計図としては
足りていない点があります。
例えば、  

・メインビジュアルはリキッドデザインになっているが、その他のコンテンツは幅が想定されていない。  
・コーディングで再現するのは難しい部分がある。  
・レスポンシブデザインを意識したとき、レイアウトの変化を意識していない。  

なので、画像の切り出し方に困ってしまったり、作りなおしになった部分もありました。
また、参考にしたWebサイトを見ると、スクロールしてコンテンツが表示されると簡単なアニメーションと共に表示される仕掛けが（フェードインするなど）がありました。  

これを導入するかディレクター側では答えを持っていませんでした。なので、私は「動画」を扱っている以上、動きのある演出の方が良いと提案し、動きを入れるようにしました。  

このような形で導入が決まったのでレイアウト構成の作業をしながらアニメーションを追加し、私の感覚で単調にならないように工夫しながら実装しました。
このため、ディレクター側で考える工数より多くの時間が私の作業段階で発生しました。

更に、完成間近のタイミングでコンペナビのページからこのLPにリンクを貼る依頼を受けました。  

ディレクターの指示では、  

・ヘッダー部分にテキストとボタンを設置してほしい。  
・コンペ全般の主催をすることを進めるページにリンクするボタンを設置してほしい  

という物でした。  
ヘッダー部分は問題なかったのですが、後者の依頼は、意図を聞いてみると新サービスなので、関連項目として見せたいとのことでした。  

このような意図であるならば、ボタンではテキストの説明が必要になるし、テキストを書けばページ本来の趣旨を妨害してしまう。だからバナーの形にするべきと説明しました。  
結果、バナー制作という想定してないコストもかかることになりました。



### 反省点：  
・コーダーに依頼するのであれば、このような形のワイヤーでよいが、デザインも含めて依頼するなら作りすぎている。  
・コーディング開始前に実現できるか検討した上で作業に入るべきだった。  
・コーダーに渡すワイヤーなら、動的なイメージについてどのようにするかも含めて検討して渡すべきだった。  
・全体的な見積もりがそもそも甘い。  


## まとめ
今回の案件はディレクター側も私のスキルを知っているという前提での依頼の仕方になっています。また、制作部としても比較的にリソースを割けるタイミングだから、着手したものでした。  
しかし、社内案件でも、社内の人を使うから無尽蔵に使える物ではありません。
      
成果物としては良い物が作れましたが、全体的に多くのコストをかけてしまいました。この点については、企画段階でチーム全体での相談が足りなかったことに原因があります。  
今後はもっとコミュニケーションを取り、よく相談しながら業務にあたっていきます。




3909820_m.jpg

制作するにあたりディレクションの重要性を改めて感じたこと 

## はじめに
Reactでフロントエンドの開発を行う場合に、おそらく一度は誰でも状態管理に頭を悩ませるのではないでしょうか。  
2023年10月現在、Redux、React Hooks、zustand、そしてここで取り上げる Recoil、Jotai など、Reactの状態管理をするためのライブラリや方法は数多く存在ます。  
多くの開発者によりその使い方が模索・洗練されていますが、絶対的な正解というものは存在しません。  
故に、プロジェクトに導入する場合に、どれを選定するかで、とても迷う方は多いのではないでしょうか。  
このブログでは、私が状態管理のライブラリを選定するときに悩んだ内容から、案件の向き不向きについて考察し、ご紹介したいと思います。  

**[2024.6.3 追記] Recoilから正式に発表されているわけではありませんが、2023年3月以降アップデートがなく、Recoilの開発は実質的に打ち切られてしまったようです。そのため、Recoilを選択することは避けた方がよさそうです…  
参考: <a href="https://github.com/facebookexperimental/Recoil/issues/2318" target="_blank">React 19 support · Issue #2318 · facebookexperimental/Recoil</a>**

**→ [2024.7.19 追記] [Reduxへ移行する方法の記事](https://sterfield.co.jp/blog/recoil-to-redux/)を投稿しました。**

## まず Redux、zustand と Recoil、Jotai の違いについて
Redux は、Reactを作ったFacebookが提唱した[Flux](https://github.com/facebookarchive/flux/tree/main/examples/flux-concepts)というアーキテクチャをもとにした、初期から最も利用されている状態管理ライブラリです。  
Reactとは切り離して１つのストアに集約して管理するため、情報の流れが一方通行で辿りやすい特徴があります。WEBアプリ全体の一貫性を重視し、堅牢な作りにする場合、Reduxは有望な選択肢となります。  
しかしながら、Reduxは非同期通信を伴うような複雑な状態管理ではそのまま使うのはあまりにもコードが膨大になってしまうため、サードパーティのプラグインなどを導入することが現実的な選択肢となります。また、1つのストアで管理するため、コンポーネント単位でのカプセル化が苦手です。  
  
zustand はこのReduxの苦手な部分を補うことで、Reduxからの乗り換えが進んでいるライブラリです。  
基本的な思想はReduxと同じですが、Reduxで煩雑になるような記述をより簡潔に書くことができます。 
  
Recoil は Redux とは違う思想で、ストアを複数持ち、それぞれに対して別々のコンポーネントからアクセス可能です。ストアが一元管理されているReduxやzustandとちがい、コンポーネント単位でのカプセル化がしやすく、データとアプリ全体の結合を制限することに向いているので、柔軟性を重視するアプリに向いていると言えそうです。
ただ、複数のストアに別々のコンポーネントから双方向でアクセスできる特徴が故に、組み方によってはReduxと比べると情報の流れを辿りにくくなる可能性があることに注意が必要です。  
  
Jotai は Recoil をより簡潔に記述できるようにしたライブラリで、[npm trends](https://npmtrends.com/Jotai-vs-react-redux-vs-recoil-vs-zustand)を見ると、2023年10月現在、本家のRecoilを追い抜いています。  

## RecoilよりJotaiが向いている案件
RecoilとJotaiで同じ状態管理をするためのコードを比べてみましょう。
#### Recoil
```typescript
const exampleState = atom({
  key: "exampleState",
  default: 0
});
const exampleSelector = selector({
  key: "exampleSelector"
  get ({ get }) => `${get(exampleState)}個を選択中`
});
```
#### Jotai
```typescript
const exampleState = atom(0);
const exampleSelector = atom((get) => `${get(exampleState)}個を選択中`);
```
こうやって並べてみるとよく分かりますが、  
Jotaiの方が圧倒的にコード数が少なくなります。  
Recoilで用意されている機能の多くはJotaiでも利用できるので、よりシンプルに状態管理を行いたい場合は、  Jotaiが向いていると言えます。  
  
## JotaiよりRecoilが向いている案件
では、次の場合はどうでしょう。  
#### Recoil
```typescript
// Writable
const idState = atom({
  key: "idState",
  default: 1
});

// Read Only
const fetchState = selector({
  key: "fetchState",
  get: async ({ get }) => {
    const id = get(idState);
    try {
      const response = await fetch(`example.api.json?id=${ id }`);
      const json = await response.json();
      return json;
    } catch (error) {
      throw error;
    }
  }
});

// Writable (default value fetched)
const complexState = atom({
  key: "complexState",
  default: selector({
    key: "complexSelector",
    get: async ({ get }) => {
      const json = await get(fetchState);
      return {
        id: json.id,
        name: json.exampleName
      }
    }
  })
});
```
#### Jotai
```typescript
// Writable
const idState = atom(1);

// Read Only
const fetchState = atom(async (get) => {
  const id = get(idState);
  try {
    const response = await fetch(`example.api.json?id=${ id }`);
    const json = await response.json();
    return json;
  } catch (error) {
    throw error;
  }
});

// Writable (default value fetched)
const defaultComplexState = atom(async (get) => {
  const json = await get(fetchState);
  return {
    id: json.id,
    name: json.exampleName
  }
});
const overWrittenComplexState = atom(null as { id: number; name: stirng; });
const complexState = atom<number, [number], void>(
  async (get) =>
    (await get(overWrittenComplexState)) ||
    (await get(defaultComplexState)),
  (_get, set, update) => set(overWrittenComplexState, update)
);
```
このように初期値をフェッチしつつ、後からデータの上書きもできるようなストアを作ろうとするような複雑な処理をさせようとした場合、JotaiよりRecoilの方が分かりやすいコードになることがわかるかと思います（もっと上手な書き方があったらすみません）。  
また、フェッチしたデータをリセットできるようにする場合、  
  
#### Recoil
```jsx
const exampleState = atom({
  key: "exmapleState",
  default: 0
})
const ExampleComponent = () => {
  const [example, setExample] = useRecoilState(exampleState);
  const reseter = useResetRecoilState(exampleState);
  const handleAddClick = () => setExample(previousState => previousState + 1);
  return (
    <div>
      <p>{example}</p>
      <button onClick={handleAddClick}>追加</button>
      <button onClick={reseter}>リセット</button>
    </div>
  )
}
```
のように、Recoilはatomに対してそのままuseResetRecoil()を使うことでリセット可能ですが、  
  
#### Jotai
```jsx
const exampleState = atomWithReset(0);
const ExampleComponent = () => {
  const [example, setExample] = useAtom(exampleState);
  const reseter = useResetAtom(exampleState);
  const handleAddClick = () => setExample(previousState => previousState + 1);
  return (
    <div>
      <p>{example}</p>
      <button onClick={handleAddClick}>追加</button>
      <button onClick={reseter}>リセット</button>
    </div>
  )
}
```
のように、Jotaiでは、あらかじめreset用のutil（atomWithRest）を使ってatomを用意する必要があります。  
その他にも、Jotaiでは複雑な操作をしようとした場合に、Recoilと同様の操作をするためにより多くのutilを使ったり、helperを自前で用意しなければいけない場合に遭遇します。  
  
これらのことから、より複雑なデータ処理を扱うような使い方をする場合、Recoilの方が向いていると言えます。  

## まとめ
堅牢でアプリ全体を見通すことを優先するのであれば Redux。  
基本的な思想はReduxと同じだけど、よりシンプルに描きたいのであれば zustand。  
機能追加やコンポーネントの入れ替えが多いような柔軟性のあるアプリで、複雑なデータ管理が必要なら Recoil。  
柔軟性とシンプルさを重視するなら Jotai というのが、現時点での自分の選択基準でした。

## 参考リンク

- [Jotai](https://jotai.org/)
- [Recoil](https://recoiljs.org/)
- [Redux](https://redux.js.org/)
- [zustand](https://github.com/pmndrs/zustand)
- [npm trends: jotai vs recoil vs redux vs zustand](https://npmtrends.com/jotai-vs-recoil-vs-redux-vs-zustand)

20231006_1.png

Reactの状態管理ライプラリはRecoilとJotaiならどちらをえらべばいいか？

ツイートのいいね数やコメント数、YouTubeの投稿日時、Amazonなどネットショップのレビュー数、通貨ごとの適切な価格表示など、UX（ユーザーエクスペリエンス）の向上やコンテンツや商品の競争力を高めるためには、これらの数字をユーザーが一目で理解できるようにすることが一つのポイントになります。

また、数字が非常に長い場合は、簡潔に表示する方が読みやすいです。さらに、ユーザーの使用言語や文化に合わせて、数字を適切に表示することが良いでしょう。

上のように数字、日付、価格を簡潔に表示するために、外部ライブラリを使用せずに、JavaScript標準仕様にあるIntl APIを使用するとより簡便に実装できます。

### Intl API
**Intl** APIはinternationalization（国際化）APIの略で、下記はMDNからの引用です。

> **`Intl`** オブジェクトは、 ECMAScript の国際化 API の名前空間で、言語に依存した文字列の比較、数値の書式化と、日付の書式化を提供します。 **`Intl`** オブジェクトは、いくつかのコンストラクターに加え、国際化コンストラクターや他の言語に関する関数に共通する機能へのアクセスを提供します。
> 

また、internationalizationは始めのiから終わりのnまでの間に18文字入っていることで**i18n**と呼ばれています。

ほとんどの最新のブラウザでサポートされているため、互換性を心配せずに使用できます。

では、いくつかの使い方を紹介します。

## 数字を簡潔に表示
`Intl.NumberFormat`を使用します。
viewsに閲覧数を表す数字を入れています。このように大きな数字をそのまま表示すると読みにくくなります。
最初の引数には言語を指定するだけで良いので、日本語の場合は`ja-JP`を指定します。
```
const views = 9741275;
const formatter = new Intl.NumberFormat('ja-JP');

console.log(formatter.format(views));  // 9,741,234
```
より簡潔に表示するには、2番目の引数にさまざまなオプションを指定できます。オプションの中で`notation: 'compact'`を指定するとコンパクトになります。
```
const views = 9741275;
const formatter = new Intl.NumberFormat('ja-JP', {
    notation: 'compact'
});

console.log(formatter.format(views));  // 974万
```
さらに、1番目の引数に言語ブラウザのAPIでサポートされている`navigator.language`を指定すると、ユーザーがブラウザで設定した言語を自動的に取得でき、ユーザーが指定した言語に応じて数字を表示できます。
```
const views = 9741234;
const formatter = new Intl.NumberFormat(navigator.language, {
  notation: 'compact'
});

console.log(formatter.format(views));  // 974万
```
## 価格を通貨に合わせて簡潔に表示
同様に`Intl.NumberFormat`を使用します。
1番目の引数には同じく言語を、2番目の引数のオプションで`style: 'currency'`に設定し、currencyオプションで通貨`currency: 'JPY'`を指定します。
```
const price = 1000000;
const formatter = new Intl.NumberFormat('ja-JP', {
  style: 'currency', 
  currency: 'JPY'
});

console.log(formatter.format(price)); // ￥1,000,000
```
ここでも"compact"オプションを使用してコンパクトにすることができます。compactオプションは価格よりはいいねの数など大体の数を表す時にいいかもしれません
```
const price = 1000000;
const formatter = new Intl.NumberFormat('ja-JP', {
  style: 'currency', 
  currency: 'JPY',
  notation: 'compact'
});

console.log(formatter.format(price)); // ￥100万
```
## 相対時間をスマートに表示
商品や記事がいつ公開されたか、何日前、何時間前に投稿されたかを表す必要もあります。相対時間をスマートに表示するためには`Intl.RelativeTimeFormat`を使用します。
`format`の1番目の引数は数字で、2番目には日付か時間か月かなどを指定します。
```
const formatter = new Intl.RelativeTimeFormat('ja-JP');

console.log(formatter.format(1, 'day')); // 1 日後
```
オプションに`numeric: 'auto'`にすると言葉を変えてくれます。
```
const formatter = new Intl.RelativeTimeFormat('ja-JP', {
  numeric: 'auto'
});

console.log(formatter.format(1, 'day')); // 明日
```
入社して何日経ったかを示したい場合、今日を基準にして、入社日の日付を指定し、現在までの日数を計算し、フォーマッタを使用すると、"〜日前”と表示されます。
```
const today = new Date();
const startDate = new Date(2021, 4, 17); // 2021年5月17日　monthは0から始まるため5→4
const daysPassed = Math.ceil((startDate - today) / (1000 * 60 * 60 * 24));
const yearsPassed = Math.ceil((startDate - today) / (1000 * 60 * 60 * 24　* 365));
const formatter = new Intl.RelativeTimeFormat('ja-JP', {
  numeric: 'auto'
});

console.log(formatter.format(daysPassed, 'day')); // 857 日前
console.log(formatter.format(yearsPassed, 'year')); // 2 年前
```
ただし、2番目の引数は日か時間かのどちらか1つだけを指定できます。

この問題を補完できるライブラリ`timeago.js`がありますが、時間がどれだけ経過したかに応じて日か時間かを自動的に表示されるので、相対的な時間のみが必要な場合に便利かと思います。

## 日付と時間を正確に表示
時間を表示するときには、コンパクトにしてより読みやすい場合もありますが、正確な日付を表示する必要があるときもあります。その場合は`Intl.DateTimeFormat`または`toLocalDateString`を使用します。
```
const today = new Date(); // 作成日基準の今日

console.log(today.toString()); // Thu Sep 21 2023 12:05:01 GMT+0900 (日本標準時)
console.log(new Intl.DateTimeFormat('ja-JP').format(today)); // 2023/9/21
```
これをさらに簡略化した方法もあります。
```
const today = new Date();

console.log(
  today.toLocaleDateString('ja-JP', {
    minute: 'numeric',
    hour: 'numeric',
    day: 'numeric',
    month: 'short',
    year: 'numeric',
    weekday: 'short'
  })
); // 2023年9月21日(木) 12:18
```
日付にtoLocaleDateStringを使用するだけで、内部的にはIntl APIを使用するため、より簡単にフォーマットを使用できます。言語を指定するだけでその言語に合わせたフォーマットが表示されます。さらに、さまざまなオプションを指定することもできるので、より簡単にまたはより詳しく表示できます。

### まとめ

IntlはJavaScriptの標準仕様であるので、定期的に更新され常に最新の国際化に向けた実装が可能です。また、外部ライブラリに依存せずに使用できることも良い点です。もちろん一つの言語だけを対応するサイトでも使用でき、その言語に合わせたフォーマットにしてくれるので別途用意しなくて済みます。

日々の開発においても活用していきたいと思います。


#### 参考
- https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Intl
- https://cercopes-z.com/JavaScript/Object-Intl-js.html


【JavaScriptのIntl】数字や日付、価格の表示をスマートに

## はじめに

本記事では、これから TDD の導入を考えている方や、TDD を導入している案件に携わる方に向けて、私が実際に TDD をやってみて感じたメリット・デメリットをまとめたいと思います。

## テストの重要性

テストは、ソフトウェアの品質向上や開発効率化に欠かせないものになってきています。テストを効果的に活用することで、ソフトウェアの品質や信頼性を向上させ、開発コストを削減することができます。

## TDD(テスト駆動開発)とは

テスト駆動開発（Test-Driven Development、TDD）は、ソフトウェア開発の手法の一つで、テストの作成から始めて、その後にコードを実装するというサイクルを繰り返すことで、品質の高いソフトウェアを開発する手法です。
手動テストするのではなく、[Jest](https://jestjs.io/ja/)や[JUnit](https://junit.org/junit5/)などのテストフレームワークを使用します。

一般的な開発では、下図のように設計とテスト作成は分けて行うと思います。

 ![image](/uploads/20230908_2_b6073f3e4b.png) 

TDD では、最初にテストを作成します。
テスト作成 ≒ 設計のようなイメージです。

 ![image](/uploads/20230908_3_11d5709f45.png) 

## TDD の基本サイクル

TDD は「レッド」「グリーン」「リファクタリング」と呼ばれる工程で進められます。各工程で何をするのか、説明していきます。

### レッド

要件から、実装する機能のテストを作成します。この段階では実装をしていないので、テストはすべて失敗します。
テストツールを使っているときにテストが失敗すると赤色でエラー表示されるため、この工程はレッドと呼ばれます。

### グリーン　

レッドで作成したテストをもとに、実装を行います。
ここで重要なのは、完璧なコードを書くことではなく、先に設定したテスト条件を全てクリアさせるだけの「最小限」のコードを書くということです。
テストツールを使っているときにテストが通ると緑色でエラー表示されるため、この工程はグリーンと呼ばれます。

### リファクタリング

すべてのテストが通るようになったら、リファクタリングを行ってコードの可読性を高めます。
この工程は後回しになりがちですが、プログラムの規模が大きくなると大変になってしまうので、こまめにリファクタリングすることをお勧めします。

## TDD のメリット

TDD を実施すると、以下のようなメリットがあります。

### 安心して実装ができる

テスト条件を全てクリアさせるように実装することで、実装漏れやバグの発生を抑制できます。
また、何を実装すれば良いのかはテストを見ればすぐにわかるので、工数の削減が期待できます。

### 品質向上

テストが既にあることで、開発者がコードを変更する際にも、影響を受ける他の部分に対して問題がないかを確認できます。また、テストが十分にカバレッジされている場合、バグやエラーを早期に発見できるため、ソフトウェアの信頼性が向上します。

### ドキュメントとしての役割

テストコードはソフトウェアの仕様や振る舞いを示すドキュメントとして機能します。ソフトウェアの動作がテストによって明確になり、コードの理解が容易になります。
テストコードはソフトウェアの変更に伴って、常に最新の状態に保つ必要があります。そのため、テストコードはソフトウェアのバージョン管理システムに登録し、管理することが一般的です。

### リファクタリングのサポート

リファクタリングを行う前に、テストケースを実行して、リファクタリング後にもテストが通ることを確認することで、ソフトウェアの外部的な振る舞いを保てていることになるため、安全にリファクタリングを行うことができます。
また、リファクタリングで起きがちなデグレ(デグレード)やバグの発生を防止できます。

## TDD のデメリット

TDD は、ソフトウェアの品質向上や開発効率化に効果的な手法ですが、導入にはいくつかの課題があります。

### テストを作るのに時間(工数)がかかる

TDD は、テストコードを先に作成する必要があるため、開発プロセス全体において時間がかかることがあります。
ただし、長期的にはバグの減少や品質向上が見込めることから、開発全体で考えると時間の節約と考えることもできます。

### 熟練度と学習コスト

TDD は、初めて取り組む開発者にとっては学習コストがかかる場合があります。
効果的なテストを作成するためには、適切なテストケースを選択し、適切なカバレッジを持つことが必要です。
しかし、開発の初期段階に完璧なテストコードを書くのは難しいので、今思い浮かぶ機能の中でテストを作成し、仕様変更などのタイミングでより細かいテストを増やしていく方針で進めていました。

### テストの保守

ソフトウェアの変更に伴い、テストコードも頻繁に更新する必要があるため、テストの保守に工数がかかることがあります。
TDD を導入する際にはその負担をチームに理解してもらう必要があります。

## 課題の解決策

TDD の課題を解決するためには、以下のような対策が考えられます。

### テストコードの自動生成ツールを活用する

テストコードの自動生成ツールとは、ソフトウェアの設計や仕様を元に、テストコードを自動的に生成してくれるツールです。
例えば、テストフレームワークに[Jest](https://jestjs.io/ja/)を使用しているのであれば、[jest-test-gen](https://github.com/egm0121/jest-test-gen)などがあります。
テストコードの自動生成ツールを活用することで、テストコードの作成にかかる時間を短縮することができます。

### テストケースの標準化を図る

テストケースの標準化とは、テストケースの作成や評価に使用するルールや手法を定義することです。
テストケースの標準化をすることで、開発者の経験やスキルに依存することなくテストコードを作成できるため、テストコードの作成や保守の効率化を図ることができます。

### チームでのテスト文化を醸成する

チームでのテスト文化を醸成することで、テストの重要性や必要性を理解してもらい、テストへの協力を得やすくなります。

## まとめ

私は気になるところがあるとすぐにリファクタリングしたくなっちゃう性格なので、TDD にはとても助けられています。
TDD は、一見面倒な手法に思われるかもしれませんが、バグの早期発見や仕様の理解、コードの品質向上など、多くのメリットがあります。
メリットとデメリットを理解した上で、適切に活用していきましょう！

## 参考リンク

- [テスト駆動開発（TDD）とは？基本サイクルと運用時の注意点を解説！【ソフトウェア開発・テスト用語 】| Qbook](https://www.qbook.jp/column/713.html)
- [テスト駆動開発（TDD）入門](https://products.sint.co.jp/ober/blog/tdd)
- [テスト駆動開発（TDD）とは？目的やメリット・デメリット、やり方を解説 ｜ソフトウェアテストの SHIFT](https://service.shiftinc.jp/column/4654/)

20230908_1.jpg

TDD(テスト駆動開発)について

Shopeeの商品情報は非常に複雑で、そのため出力できるCSVデータも複雑であり正直わかりやすい状態ではありません。
なので出力できるファイルとその中身についてまとめます。

出力できるファイルは以下の5つです。

mass_update_basic_info
mass_update_sales_info
mass_republish_items
mass_update_shipping_info
mass_update_media_info

それぞれの内容と項目は以下のとおりです。

### mass_update_basic_info
Product ID: Shopeeの商品IDです
Parent SKU: 該当商品の登録情報「Parent SKU」が出力されます
Product Name: 商品名
Product Description: 商品說明
Fail Reason: 基本的に空欄

### mass_update_sales_info
Product ID: Shopeeの商品IDです
Product Name: 商品名
Variation ID: バリエーションIDです。バリエーションの有無に関わらず値が入ります        
Variation Name: バリエーション名です。バリエーションが2つある場合はセル内にカンマ区切りで2つ入ります     
Parent SKU: 該当商品の登録情報「Parent SKU」が出力されます
SKU	Price: バリエーションごとの価格です    
Stock; バリエーションごとの在庫です    
Fail Reason: 基本的に空欄

### mass_republish_items
Product ID: Shopeeの商品IDです
Product Name: 商品名
Parent SKU: 該当商品の登録情報「Parent SKU」が出力されます
Sales: 過去の販売件数
Stock: バリエーションごとの在庫    
Action: ステータスをDelist または Publish
Fail Reason: 基本的に空欄

### mass_update_shipping_info
Product ID: Shopeeの商品IDです
Parent SKU: 該当商品の登録情報「Parent SKU」が出力されます
Product Name: 商品名
Product Weight/kg: 重さ
Length: 長さ
Width: 横幅
Height: 高さ
Shipping Toggle: 配送切替onまたはoffを指定
I will cover shipping fee: 送料無料onまたはoffを指定
Shipping fee: 配送料
Fail Reason: 基本的に空欄

### mass_update_media_info
Product ID: Shopeeの商品IDです
Parent SKU: 該当商品の登録情報「Parent SKU」が出力されます
Product Name: 商品名
Category: カテゴリのIDと構造。例: 100893 - Beauty/Skincare/Facial Moisturize
Cover image: カバー画像のURL
Item Image 1〜8: 画像1〜8のURL
Size Chart: サイズチャート画像のURL
Variation Name1: バリエーション1の名前    
Option 1 Name〜Option 30 Name: オプション1〜30の名前
Option 1 Image〜Option 30 Image: オプション1〜30の画像URL
Fail Reason: 基本的に空欄


一括での引っ越し作業などの際参照いただければ幸いです。

Shopeeで出力できる商品CSVの種類と内容

# 軽量でセキュアなコンテナイメージを使ってみよう

## はじめに
みなさんは開発にDockerコンテナを使っていますか？ここでいうコンテナとはDockerやDocker互換のコンテナエンジンで動作させられるものを指します。
当社でもDockerコンテナを積極的に利用して開発環境から本番までシームレスな開発、運用ができるよう導入を進めています。

さてそんなDockerコンテナですが、コンテナイメージを管理するためのDockerfileは適切に管理できているでしょうか。
ファイルシステムが差分構成になっていることなどDocker特有の仕組みがあり、ネット上にあるサンプルをそのまま使っているだけで自分たちで中身を書くところまではできてない人が多いのではと想像します。

本記事ではそのような状態から一歩レベルアップするため、Distrolessというベースイメージを使うようDockerfileを書き換えるやり方とその結果どういうことが得られるかを解説していきます。

## Distrolessとは
そもそもDistrolessとはどういうもので、どういう利点があるのでしょうか？
開発元でGoogleのAIであるBardに聞いてみた内容を引用します。

> 引用：Bard（Google AI）

> 質問
> distrolessを使う利点はなんですか？
> 
> 回答
> Distroless は、Google によって開発された、Linux オペレーティングシステムを最小化した Docker コンテナイメージです。Distroless は、アプリケーションを実行するために必要な最小限のファイルとライブラリのみを含むため、軽量でセキュリティに優れています。
> 
> Distroless を使用する主な利点は次のとおりです。
> 
> - 軽量：Distroless は、従来の Linux ベースの Docker コンテナイメージよりも軽量です。これは、Distroless がアプリケーションを実行するために必要な最小限のファイルとライブラリのみを含むためです。
> - セキュリティに優れている：Distroless は、セキュリティに優れています。これは、Distroless がアプリケーションを実行するために必要な最小限のファイルとライブラリのみを含むため、攻撃対象領域が狭いためです。
> - スケーラブル：Distroless はスケーラブルです。これは、Distroless が軽量であるため、多くのコンテナを実行してもシステムに負荷がかかりにくいためです。
> 
> Distroless は、軽量でセキュリティに優れた Docker コンテナイメージを必要とするアプリケーションに最適です。たとえば、Web サーバ、データベースサーバー、アプリケーションサーバなどです。

「軽量でかつセキュリティに優れている」というところに着目してDistrolessを使って進めていきます。

## プログラム
実際の運用イメージにあわせるため、下記のようなExpressを使ったNode.jsアプリを動作させるコンテナを作るDockerfileを対象にします。

- app/app.ts
  ```
  import express from "express";

  const app = express();
  const port = 3000;

  app.get("/", (_req, res) => {
    res.send("Hello World!");
  });

  app.listen(port, () => {
    console.log(`Example app listening on port ${port}`);
  });
  ```
- package.json
  ```
  {
    "dependencies": {
      "express": "^4.18.2",
      "typescript": "^5.1.6"
    },
    "devDependencies": {
      "@types/express": "^4.17.17"
    },
    "scripts": {
      "build": "tsc"
    }
  }
  ```
- tsconfig.json
  ```
  {
    "compilerOptions": {
      "target": "es2016",
      "module": "commonjs",
      "outDir": "./dist",
      "esModuleInterop": true,
      "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,

      /* Type Checking */
      "strict": true /* Enable all strict type-checking options. */,
      // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
      // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
      // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
      // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
      // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
      // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
      // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
      // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
      // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
      // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
      // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
      // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
      // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
      // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
      // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
      // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
      // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
      // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */

      /* Completeness */
      // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
      "skipLibCheck": true /* Skip type checking all .d.ts files. */
    },
    "include": ["./src/**/*"]
  }
  ```

### Dockerfile(変更前)
```
FROM node:18-slim
WORKDIR /app
COPY . .
RUN npm install && npm run build

CMD [ "node", "./dist/app.js" ]
```
変更前のDockerfileは上記の通りで、公式で提供されているNode.jsのイメージをそのまま使うだけのDockerfileになります。

### Dockerfile(変更後)
```
FROM node:18-slim as builder
WORKDIR /app
COPY . .
RUN npm install && npm run build

FROM gcr.io/distroless/nodejs:18
ENV NODE_ENV production
WORKDIR /app
COPY --from=builder --chown=nonroot:nonroot /app/dist/app.js ./dist/app.js
COPY --from=builder --chown=nonroot:nonroot /app/node_modules ./node_modules
USER nonroot
CMD [ "./dist/app.js" ]
```
Distrolessを使うように書き換えたものがこちらになります。その中でも特に2点について下記で解説します。

### 変更内容のポイント
1. マルチステージビルド

    Distrolessには実行に必要な最低限のパッケージしか含まれていないため、npmコマンドどころかshell環境自体が存在しません。
    そのため、Dockerのマルチステージビルド機能を利用します。詳細な仕組みの説明は割愛しますが、Dockerfileの前半部分(1行目〜4行目)で
    標準Node.jsイメージを使ってアプリケーションをビルド(ライブラリのインストールとTypescriptのコンパイル)、
    後半部分(6行目〜12行目)でdistrolessに前半でビルドしたファイルのコピーするという2段階構成にします。
    このように変更することでnpmコマンドや、ソースファイルのようなアプリケーション実行に必要がないファイルをイメージファイルに含めないことを実現します。

2. 非root化

    Distrolessとは直接関係ないですが、Docker公式にもベストプラクティスとして書かれている非root化も一緒に行ってます。
    Distrolessイメージではrootユーザー以外にnonrootというユーザーが存在しているため、ファイルのコピー時とCMD実行前にnonrootを指定することでroot権限を持たないユーザーでプログラムを実行できるようになります。

### イメージのサイズの比較
まずはビルドしたイメージのサイズを比較してみます。

- 変更前→express-slim
- 変更後→express-distroless

となります。

```
➜ docker image ls
REPOSITORY           TAG       IMAGE ID       CREATED        SIZE
express-slim         latest    afe678706d58   37 hours ago   312MB
express-distroless   latest    6a1421f17b86   37 hours ago   207MB
```

3割程度小さくなっていることがわかります。
サイズが小さくなることでビルド後のイメージを保存する先のストレージ容量の節約や、デプロイ時間の短縮が期待できます。

### 脆弱性の数の比較
次に[Trivy](https://trivy.dev/)というコンテナイメージの脆弱性スキャナーをつかって検出される脆弱性の個数を比較してみます。

```
➜ trivy image express-slim
(省略)
Total: 51 (UNKNOWN: 0, LOW: 50, MEDIUM: 0, HIGH: 1, CRITICAL: 0)
(省略)

➜ trivy image express-distroless
(省略)
Total: 23 (UNKNOWN: 0, LOW: 11, MEDIUM: 8, HIGH: 4, CRITICAL: 0)
(省略)
```

今回は細かい内容までは追わずに単純な個数で比較しますが、脆弱性の数が半分以下になっていることがわかります
（HIGHが多いのが気になりますが・・）

## その他TIPSなど
### 開発中はSSHできないと不便
:debugタグをつけたイメージを利用することで一般的なコンテナイメージと同様にdocker runコマンドでsshログインが可能になります。

```
FROM gcr.io/distroless/nodejs:18
↓
FROM gcr.io/distroless/nodejs:18:debug
```

### 軽量なコンテナイメージとしてはAlpineのほうが有名なのになぜDistrolessを採用しているのか
Alpineは軽量にするため特殊構成をとっているディストリビューションであり、標準Cライブラリに一般的なglibcではなくmuslを採用しています。
Node.jsではmuslを採用しているプラットフォームで動作させる場合のサポートレベルはExperimentalとなっています(2023年8月現在)。
この点から、実運用時の安定性のことを考えて一般的なディストリビューションであるDebianベース(=標準Cライブラリがglibc)のDistrolessを使いました。

## まとめ
今回はNode.jsのアプリケーションを動かすコンテナをDistrolessを使って構築してみましたが、変更自体も簡単で、記事内で解説したとおり軽量かつセキュアなコンテナにするという目的が達成できそうです。

その要因として、Node.jsインストール済みのイメージがDistrolessで提供されていることが大きかったのですが、たとえばPHPのように標準で提供されてないアプリケーションのコンテナイメージを構築する場合、自前でミドルウェアを追加する作業が必要になり、軽量かつセキュアというメリットがあまり活かせないことになりそうです。

用途に応じた使い分けが必要だと感じました。

## 参考リンク
- [Distroless](https://github.com/GoogleContainerTools/distroless)
- [Best practices for writing Dockerfiles](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/)
- [DockerでNode.jsを動かすときのベストプラクティス](https://blog.shinonome.io/nodejs-docker/)
- [Node.js Docker baseイメージには alpine < distroless < ubuntu+slim 構成がよさそう](https://zenn.dev/jrsyo/articles/e42de409e62f5d)

20230825_1.png

軽量でセキュアなコンテナイメージを使ってみよう

## React初体験

今月にスターフィールド のWebサイトが新しくリニューアルされました。この開発に伴い始めてReact環境で開発を体験しました。
ReactはJavaScriptのライブラリの一種と聞いてはいましたが、Webデザイナーとして経験してきたJavaSciptの開発とは全く別物のように感じました。

このブログでは、React環境での開発体験を詳しくまとめて、初心者がReactに挑戦する際に直面するであろう注意点、気づいたポイントについてまとめます。


## そもそもReact とは？

ReactはJavaScriptライブラリであり、主にユーザーインターフェースを構築するのに向いています。近年、Webサイトを構築する上でheader、footerなど
共通部分をモジュール化し、それを読み込ませてページを作ります。
Reactはこのモジュール化の考え方が色濃く表れてる言語という印象を受けました。また、そのため今までの開発環境と大きく変わりました。

例えば、jQuery環境で開発する場合、一般的には<head>タグ内にjQueryファイルを読み込むコードを記載するでしょう。そして、topページ内ではメインビジュアルをslickスライダーなどのモジュールを読み込み動きを設定し、CSSで装飾をする。などの流れで動きのあるリッチコンテンツを作ります。

しかし、Webサイト全体を見た場合、例えばプライバシーポリシーページなど、ただテキストを配置するだけで、特別な仕掛けもないページも存在します。このとき、不要なページにもjQueryファイルを読み込ませてしまい、サーバーには余計な負荷を書けることになります。

一方、Reactの場合、例えばメインビジュアルのスライダーは<slider>などの名前でモジュール化します。そして、このモジュール専用のHTMLとCSSを作成してまずこの部分だけ完成させます。その後、必要なページの必要な箇所でこの<slider>を読み込みWebページを作成します。
各ページ毎に読み込むページが必要最低限で済むのでデータ通信の容量を軽くできます。

一見すると、WordPressでもよく使われる「include」により、各パーツを指定してページを構成する方法と似ていますが、大きく違うのはWordPressは呼び出すデータはHTMLだけになります。そのため呼び出したページのCSSで、読み込んだHTMLに改めてスタイルを適用させる必要があります。  
しかし、Reactの場合はCSSも適用された完成形の形でモジュールが呼び出されるため、改めてスタイルを適用させるを必要もありません。

例えるなら、ブロック工法（機械や建物の製造時に、いくつかの要素を分けて同時に製造し、最後に繋ぎ合わせて完成させる工法）に近い考え方でページを作ります。


## 実際の記述について

開発を体験してみて、記述の仕方が独特と感じました。実際に特徴的だと思った点を主にまとめてみました。

・各ページ、モジュールを「.tsx」ファイルで作る。

先ずは各ページのモジュールを作ります。

```
import Head from 'next/head';
import styles from '@/styles/career.module.scss';


function 関数() {
  return (
       実際のHTML
  );
}

```


という形で記述します。

また、HTMLの記述も全てのタグを「 /(スラッシュ)」を記述して閉じなくてはいけません。大概のタグは/(スラッシュ)で閉じるので当たり前ですが、<br>や<img>タグにもそのルールが適用されて、まるでXHTMLのような記述をする必要があります。

またCSSも

```
<div className={styles.textArea}>

```

などのような形で指定していきます。


少しでもミスがあるとエラーが出てしまい、表示が崩れてしまうレベルではなく、ページその物が閲覧できない状態となり戸惑いました。


## 外部ライブラリーやプライグインを使う場合

トップ画面などで、複数枚の画像をスライダーで見せるホームページはよくあります。jQuery環境下ではこのようなコンテンツを作る際は、主に、slickスライダーなど、有名なプラグインを使うケースが多いです。Reactでもこのようなプラグインを使うことができます。

slickスライダーを例に、React で プラグインを使う場合は以下のようにします。

先ず、

```
$ npm install react-slick

（yarn を使っている場合は yarn add react-slick ）

```

とコードを導入して、プロジェクトに　silick スライダーをインストールします。

そして、.tsvファイルにCSSと同様に

```
import Slider from 'react-slick';
import "slick-carousel/slick/slick.css";
import "slick-carousel/slick/slick-theme.css";

```

と記述します。
これで　sickスライダーが使える環境が整います。

後は他のモジュールと同様に作成していきます。
例えば、


```

function slickContents() {
  const settings = {
    dots: true,
    autoplay: true,
    infinite: true,
    speed: 500,
    slidesToShow: 1,
    slidesToScroll: 1
  }
  
  return (
    <ul>
      <Slider {...settings}>
        <li><img src={img1} alt='img1' /></li>
        <li><img src={img2} alt='img2' /></li>
        <li><img src={img3} alt='img3' /></li>
      </Slider>
    </ul>
  );
}

```

などのように記述します。

```
  const settings = {
  }

```


こちらの箇所でslickスライダーの設定をします。
jQueryでは外部ファイルのjsファイルに記述して設定するケースが多いですが、記述する位置が違うだけで設定の方法は概ね同じです。

スライダーの動きを設定したあと　

```
  return (　)

```


で実際のHTMLを書き、モジュールを作成します。

そして、実際にスライダーを掲載したい位置に

```

<slickContents/>

```


と記載する事でスライダーが設置されます。

reactは全般的にこのような流れで開発を進めていきます。



## プラグインを使わないコードについて

jQuery環境で開発をする際、プラグインを使わず自分で簡単なコードを記述してコンテンツを作る場合があります。
例えば、クリックしたらclss 「on」 を追加し、CSSで実際にその変化を作るということはよくありました。

同じ事をReact環境下でも行いました。

今回実際にアコーディオン形式でクリックしたら配下のコンテンツの表示、非表示が切り替える動きを作りました。

li="dropListItem" をクリックしたら　これにon を追加したり、削除する。という動きを作りました。
そして、CSSで　li="dropListItem on"　の時は配下の hideArea が表示されるという仕掛けを作成しました。


実際には以下のように記述しました。

```
import React, {useState} from 'react';


function DropListItem ({title , text}) {
  const [isOn, setIsOn] = useState(false);
  const handleClick = () => {
    setIsOn(!isOn);
  };

  return (
    <li className={`dropListItem ${isOn ? 'on' : ''}`} onClick={handleClick}>
      <div className={styles.showArea}>
        <p>{title}</p>
      </div>

      <div className={styles.hideArea}>
        <p>{text}</p>
      </div>
    </li>
  )
}

```

先ずはReqctの「useState」という関数を使うので先に、

```
import React, {useState} from 'react';

```
と記述します。

そして、

```
function DropListItem  ({title , text})

```
と従来の流れ通りにモジュールのタイトルを設定します。

```
{title , text}

```
の部分は最後に解説します。


今回はHTMLに　on  と off　の二段階の変化があります。このように変化するとき
useStateを使います。

```
const [isOn, setIsOn] = useState(false);

```

と、記述したのは「isON」という状態になるときと、「setIsOn」という状態になるときがある。
そして、

```
useState(false);

```

と書くことで書記状態は useState で指定する変化がない状態という意味合いになります。

```
  const handleClick = () => {
    setIsOn(!isOn);
  };

```


この関数は hadleClick という関数が呼び出される度に、「setIsOn」と「isOn」　という状態が切り替わるという意味になります。

そして、実際にHTMLを記載する際に

```
<li className={`dropListItem ${isOn ? 'on' : ''}`} onClick={handleClick}>

```


と記載しました。
解説すると、先ず、

```

className={ dropListItem } 

```


と記載し、liに「dropListItem」　というclass名を付けます。

```

${isOn ? 'on' : ''}

```


この部分の意味は　isOnの状態では、class「on」を追加、そうでないときは空白を入れる、つまり何も入れない状態にする。という意味になります。

```

onClick={handleClick}

```

はクリックした際に 「handleClick」を呼ぶという状態になります。

事前に、「handleClick」は「isOn」と「setIsOn」を切り替えるように設定しているのでクリックする度に on が挿入した状態とされない状態に切り替わるようになります。

これで、動作については完成しました。後は、実際にを配置したい場所に

```

<DropListItem />

```


と記述することで配置できます。

しかし、この<DropListItem />は配下のテキストを変えて複数配置するコンテンツです。そのため、実際に変えるテキスト部分は関数にして、各<DropListItem />ごとにテキストを変えられようにしました。

そのため、先ず、

```

function DropListItem  ({title , text})

```

と記載し、

実際にテキストを変えるHTMLには


```
    <li className={`dropListItem ${isOn ? 'on' : ''}`} onClick={handleClick}>
      <div className={styles.showArea}>
        <p>{title}</p>
      </div>

      <div className={styles.hideArea}>
        <p>{text}</p>
      </div>
    </li>

```
と記載しました。

最終的には以下のように記述します。

```

<ul>タイトル1の詳細情報を記載ます。
  <DropListItem title="タイトル1" text="タイトル1の詳細情報を記載します。"/>
  <DropListItem title="タイトル2" text="タイトル2の詳細情報を記載します。"/>
  <DropListItem title="タイトル3" text="タイトル3の詳細情報を記載します。"/>
  <DropListItem title="タイトル4" text="タイトル4の詳細情報を記載します。"/> 
</ul>

```

このような流れでアコーディオン形式のコンテンツの作成ができました。


6　まとめ

Reactは今までのHTMLとCSS、それにjQueryによる開発に慣れている人から見たら全く違う物のように感じます。そのため戸惑う部分が多くあります。
しかし、モジュール単位で開発をするという性質上、複数人での開発に適していると感じました。

せっかく会社に属して仲間と共に開発の仕事をしているので、積極的に覚えてより良い物を作りたいと思いました。








react.jpg

 初めてReactで開発して感じたことのレポート

最近、WordPress以外のCMSへの移行の需要も広がりつつあるというお話を聞きます。  
CMSとして80%の圧倒的なシェアを持つWordPressですが、  
シェアの大きさゆえに攻撃の対象にもなりやすく、  
実際、攻撃を受けてセキュリティの被害に遭うことも少なくありません。  
また、多くの機能を実装できるため、実装次第で重くなりやすい特徴もあります。  
そういったこともあり、WordPressを使わないCMSへの移行を望む企業さんも増えているようです。  
   
その移行先として注目されているのが、ヘッドレスCMSと呼ばれる種類のCMSです。  
WordPressでは、コンテンツの管理とサイトのレンダリングを両方行います。   
一方、ヘッドレスCMSでは、コンテンツの管理のみを行い、サイトのレンダリングやジェネレートなどは別のサービスを利用して行います。  
そのため、サイトからコンテンツへの攻撃がされにくくなります。  
また、コンテンツの数が多くなってもサイトのレンダリングに直接影響しないため、表示速度を上げやすいメリットもあります。  
   
この記事でご紹介する「Strapi」は、Node.jsのヘッドレスCMSとしては人気があります。  
ヘッドレスCMSは多くのサービスが提供されていて、CMS選びに迷いますが、  
ホスティングサービスを利用しなければ無料で利用でき、  
Nodejsの環境があればローカルで始められるので、開発のハードルが低いのが大きな理由でしょうか。  
  
Strapiはコンテントタイプ（WordPressでいう投稿タイプやタクソノミー）フィールドを自由に構成でき、  
ユーザのロールなども管理でき、APIもRestAPIとGraphQLから選ぶことができるので、  
高い拡張性が特徴です。  
  
この記事では、Strapiでサイトを構築する１つの方法として、  
OSをUbuntu、WebサーバをNginx、サイトのジェネレートをNext.js、そしてCMSをStrapiで開発を始める方法を共有します。  
ここでは動作するまでのインストールに重点を置き、コンテンツの作成などは省略します。  
  
## 目次
1. <a href="#section1">UbuntuでNginxによるサーバを設定する</a>
2. <a href="#section2">Node.jsでNext.jsとStrapiの環境を準備</a>
3. <a href="#section3">Next.jsとStrapiでデータを連携する</a>

# UbuntuでNginxによるサーバを設定する
<a id="section1"></a>
## Nginxのインストール
参考にさせていただいたサイト: <a target="_blank" rel="noopener noreferrer" href="https://vpslife.server-memo.net/ubuntuserver2204_nginx_install/">【Ubuntu Server 22.04】Nginx公式サイトのリポジトリを使用してインストール  |  VPS Life</a>  
↑詳細はこちらのサイトが詳しいです。  
この記事ではざっくりと流れだけ触れていきます。 
  
### パッケージのインストール
```bash
$ sudo apt update
$ sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring
```
  
### 署名鍵のインポートと確認
```bash
$ curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
 | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
$ gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
```
  
正しくインポートされると以下が表示されます
```bash
pub   rsa2048 2011-08-19 [SC] [expires: 2024-06-14]
      573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
uid                      nginx signing key 
```

### リポジトリの追加とインストール
```bash
$ echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
http://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \
 | sudo tee /etc/apt/sources.list.d/nginx.list
$ sudo apt update
$ sudo apt install nginx
```
### インストールの確認
nginxのインストールに成功すると、以下のコマンドでバージョンを確認できます。
```bash
$ nginx -v
```

## ufwによるファイアウォール設定とNginxでサーバの設定
### ufw によるファイアウォール設定
そのままサーバを開設すると、セキュリティ的に良くないので、ufwを使って開放するポートを制限します。  
参考にさせていただいたサイト: <a target="_blank" rel="noopener noreferrer" href="https://mynotebook.h2np.net/post/1519">ufwの最小限設定について – とりあえずノートがわりに書いてます</a>  
  
**ufwを設定するときは、いきなり実行するとSSH接続ができなくなってしまうので、  
まずは、```ufw status``` を実行して、```Status: inactive``` であることを確認します。**

確認できたら、以下のコマンドを 1つずつ実行して、許可するポートを制限します。
```bash
$ ufw allow 22
$ ufw allow http
$ ufw allow https
$ ufw allow domain
```

そしてufwを有効化。
```bash
ufw enable
```

最後に ```ufw status``` を実行して、目的のポートが開放されていることを確認します。
```bash
$ ufw status
 Status: active

To Action From
 -- ------ ----
 22 ALLOW Anywhere
 53 ALLOW Anywhere
 22 (v6) ALLOW Anywhere (v6)
 53 (v6) ALLOW Anywhere (v6)
``` 

利用するVPSなどによっては、VPSのコントロールパネルなどで、  
別途、ポートの開放が必要です。

### Nginxでサーバの設定
ここでご紹介する方法では、Next.jsでジェネレートしたファイルを静的にNginxでサーブし、  
それとは別にStrapiでCMSをサーブします。

そのため、静的にサーブするドメインとCMSをサーブするドメインを別々に割り当てます。

#### Nginxで静的なサーブ
/etc/nginx/nginx.conf を設定して
```nginx
server {
    server_name  <サイト用のドメイン名>;

    location / {
        root   /var/www/<Next.jsのディレクトリ>/out;

        index  index.html index.htm;
    }

    error_page  404              /404.html;

    # redirect server error pages to the static page /50x.html
    #
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }

}
```

#### Strapi用の設定
/etc/nginx/conf.d/default.conf のhttpの設定で以下を設定
```nginx
http {
    ︙
    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-enabled/*;
}
```

/etc/nginx/sites-enabled/<Strapi用のドメイン名>
```nginx
server {

    listen 80;
    server_name <Strapi用のドメイン名>;

    # Proxy Config
    location / {
        proxy_pass http://127.0.0.1:1337;
        proxy_http_version 1.1;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $http_host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_pass_request_headers on;
        add_header  X-Robots-Tag "noindex, nofollow, nosnippet, noarchive";
    }
}
```
あとは、```sudo nginx -t```でNginxの設定に問題がないことを確認し、```sudo systemctl start nginx```でNginxを起動すれば、  
Nginxの設定は完了です。

さらにUbuntu上でLet's EncryptによりSSLを設定する場合は、  
↓こちらの記事の方法がとても参考になります（Nginxの設定から更新まで自動！）。  
<a target="_blank" rel="noopener noreferrer" href="https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-20-04-ja">Ubuntu 20.04でLet’s Encryptを使用してNginxを保護する方法  | DigitalOcean</a>


## Node.jsでNext.jsとStrapiの環境を準備
<a id="section2"></a>
Strapi公式のガイド: https://docs.strapi.io/dev-docs/integrations/next-js  
### Next.jsのインストール
```bash
$ npx create-next-app@latest
```
でNext.jsをインストールします。

### Strapiのインストール
ここでは、Next.jsをインストールした場所にstrapiをインストールしてみます。
StrapiをNext.jsと別の場所に置く場合などは、同じ場所にインストールしない方が良いでしょう。
```bash
$ cd <Next.jsをインストールしたディレクトリ>
$ yarn create strapi-app my-project --quickstart
```
でStrapiをインストールします。  
このとき、利用するDBをSQLite、MySQL、MariaDB、PostgreSQLから選択できます。  
SQLite以外を利用する場合は、別でMySQLなどインストール・きどうしておく必要があります。  
ここではMySQLを使った方法をご紹介します。  

### MySQLのインストール
参考にさせていただいたサイト: [Ubuntu 20.04にMySQLをインストールする方法  | DigitalOcean](https://www.digitalocean.com/community/tutorials/how-to-install-mysql-on-ubuntu-20-04-ja)
#### インストール
```bash
$ sudo apt update
$ sudo apt install mysql-server
```
#### 設定
##### パスワード
```bash
$ sudo mysql_secure_installation
```
ここでいくつか質問されるので、   
```Please enter 0 = LOW, 1 = MEDIUM and 2 = STRONG:```では 2、   
```Re-enter new password:```では新たなパスワード、   
```Do you wish to continue with the password provided?(Press y|Y for Yes, any other key for No) : ```で Y   
として、パスワードを設定します。

##### ユーザ追加と権限の付与
```bash
$ mysql -u root -p
```
```mysql
CREATE USER 'ユーザ名'@'localhost' IDENTIFIED BY 'ユーザ名';
GRANT ALL PRIVILEGES ON * . * TO 'ユーザ名'@'localhost';
FLUSH PRIVILEGES;
```
##### Strapi用DBの作成
```mysql
exit
```
```bash
mysql -u ユーザ名 -p
```
```mysql
CREATE DATABASE strapi;
```
これでMySQLの準備は完了。  
Strapiのディレクトリに既にある.env、なければ新規に.envという名前のファイルを作り、以下のように記述  
.env  
```
︙
DATABASE_CLIENT=mysql2
DATABASE_HOST=127.0.0.1
DATABASE_PORT=3306
DATABASE_NAME=strapi
DATABASE_USERNAME=ユーザ名
DATABASE_PASSWORD=パスワード
DATABASE_SSL=false
```
続いて、./config/database.jsというファイルを開き、以下のように設定します。
```javascript
module.exports = ({ env }) => ({
  connection: {
    client: 'mysql',
    connection: {
      host: env('DATABASE_HOST', '127.0.0.1'),
      port: env.int('DATABASE_PORT', 3306),
      database: env('DATABASE_NAME', 'strapi'),
      user: env('DATABASE_USERNAME', 'strapi'),
      password: env('DATABASE_PASSWORD', 'strapi'),
      ssl: {
        rejectUnauthorized: env.bool('DATABASE_SSL_SELF', false), // For self-signed certificates
      },
    },
    debug: false,
  },
});
```

Strapiのディレクトリで以下コマンドを実行すると、Strapiが立ち上がり、表示されたURLにアクセスすると、ユーザ登録画面が表示されます。
```
yarn develop
```

## Next.jsとStrapiでデータを連携する
<a id="section3"></a>
### SSGでNext.jsからStrapiのAPIを呼び出す
※Strapiでrestaurantというコンテンツタイプを作った場合を例にしています（フィールドはtitleとslugを設定）。

SSGでNext.jsからAPIを呼び出す場合、pages/ のファイルで、```getStaticProps()```を使うことで、
ページをジェネレートする前にAPIを呼び出して、静的にHTMLを出力できます。
```typescript
import axios from 'axios'

function Page ({ posts, pagination, error } {
  return (
    <section>
      <h1>ページサンプル</h1>
      <ul>
        posts.map(post => (
          <li key={post.id}>{post?.attribute?.title}</li>
        ))
      </ul>
    </section>
  )
}

export async function getStaticProps () {
  try {
    const res = await axios.get('http://localhost:1337/api/restaurants');

    return {
      props: {
        posts: res?.data,
        pagination: {
          ...res?.meta?.pagination
        }
      }
    }
  } catch (error) {
    return { error }
  }
}

export default Page
```

#### ダイナミックルーティングでSSGする
pages/restaurants/[slug]/index.tsx のようにダイナミックルーティングでslugごとのページを生成したい場合、  
```getStaticPaths```を使います。  

```typescript
import axios from 'axios';

function Page ({ post } {
  return (
    <section>
      <h1>{post?.attribute?.title}</h1>
      ︙
    </section>
  )
}

export async function getStaticPaths () {
  let paths: (string | {
    params: ParsedUrlQuery;
    locale?: string | undefined;
  })[] = []
  const res = await axios.get(`http://localhost:1337/api/restaurants?pagination[pageSize]=10000&populate=slug`)
  if (res?.data?.length > 0) {
    paths = res?.data?.map(post => ({
      params: {
        slug: post?.attributes?.slug ?? null
      }
    }))
  }
  return { paths, fallback: false }
}

export async function getStaticProps ({ params }) {
  const res = await axios.get(`http://localhost:1337/api/restaurants?filters\[slug\][$eq]=${ params?.slug }`);

  return {
    props: {
      post: res?.data?.length > 0 ? res?.data[0] : undefined,
    }
  }
}

export default Page
```

# 対応してみた感想
WordPressに比べると、事前の準備も多く必要で、慣れるまでは大変かもしれません。  
SSGの場合、記事が多ければ多いほどビルドまでに時間がかかる問題もあります。  
ただ、基本的には1つの言語でバックエンドからフロントエンドまで調整することが可能で、  
SSGが故にクライアント側の表示は高速で、ビルドするとき以外はサーバの負担も軽くすみます。  
  
Strapiはコンテンツも自由に設定でき、実際に拡張性は高いと感じました。  
また、無料で試せるので、ヘッドレスCMSの練習としてもいいと思いました。

### 2023.8.28 追記
数百ページを超えるようなサイトでは、記事を更新するたびに全ページをbuildするSSGは向きません。  
その場合、Next.jsではISR(Incremental Static Regenerate)という仕組みが用意されていて、設定を工夫することで大量のページを含むサイトにも対応できるので、そちらの利用のご検討をおすすめします。

ubuntu-nginx-nextjs-strapi.jpg

Ubuntu✖️Nginx✖️Next.js(SSG)✖️StrapiでWEBサイトの環境を作る


<h2>はじめに</h2>



<p>この記事は、クラウド上でアのプリケーションに興味の人や Google Cloud のサービスを使用して自動化されたタスクのスケジューリングと実行を行いたいと考えている人のために、Google Cloud のサービスである Cloud Run と Cloud Scheduler の連携方法と Google Cloud サービス間の認証について解説します。</p>



<h2>1. Cloud Run と Cloud Scheduler の概要</h2>



<h3>Cloud Run</h3>



<p>Cloud Run は、開発者のウェブアプリケーションやサービスを手軽にオンラインに持っていくための Google Cloud のサービスです。</p>



<ul>
<li>手間がかからない: 開発者はアプリケーションに集中でき、面倒なインフラストラクチャの管理は Google に任せられます。これにより、時間を省け、本当に重要な開発作業に集中できます。</li>
<li>低コスト: Cloud Run は、サービスにトラフィックがあるときだけ課金されます。つまり、アプリケーションが使われていないときはお金をかけずに済むので、コストを抑えられます。</li>
<li>自動スケールアップ: アプリケーションに多くのユーザーがアクセスようになっても、Cloud Run は自動でスケールアップして対応します。これにより、あなたはサービスの拡大を気にせずに済みます。</li>
<li>色々なプログラミング言語に対応: Cloud Run はコンテナを使うため、あなたが好きなプログラミング言語を自由に使うことができます。これにより、あなたは柔軟にアプリケーションを開発することができます。</li>
</ul>



<h3>Cloud Scheduler</h3>



<p>Cloud Scheduler は、定期的なジョブのスケジューリングと実するためのサービスです。cron のような構文を使用してジョブのスケジュールを設定し、指定した時間にジョブをトリガーできます。Cloud Scheduler は、HTTP リクエストや Pub/Sub メッセージの送信など、さまざまなアクションをトリガーできます。</p>



<ul>
<li>高い信頼性: ジョブの実行が保証され、高い耐障害性を持っています。スケジュールされたジョブの実行を保証します。</li>
<li>柔軟性: HTTP、Pub/Sub、App Engine など、さまざまなターゲットに対してジョブを実行できます。</li>
<li>簡単な管理: ウェブベースのコンソールやコマンドラインを使用してジョブを簡単に管理できます。</li>
</ul>



<h2>2. Google Cloud</h2>



<p>サービス間の認証方法</p>



<p>Google Cloud のサービス間で情報をやり取りする際には、認証が必要です。サービスアカウントを使用して認証情報を設定することで、異なるサービス間で安全な通信を確立できます。</p>



<p>⚠️ 注意: テストやデモ目的ではサービスアカウントのキーを直接使用することは問題ありませんが、本番環境では使用しないでください。サービスアカウントキーはシークレットな情報であり、適切に管理する必要があります。適切な管理が行われない場合、セキュリティリスクが高まり、不正アクセスを許す可能性があります。使用する前に、サービスアカウントキーの管理に関するベストプラクティスを理解してください。(<a href="https://cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys?hl=ja">https://cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys?hl=ja</a>)</p>



<h2>3. Cloud Run と Cloud Scheduler の連携方法</h2>



<h3>サービスアカウントの作成と認証</h3>



<ol>
<li>Cloud Scheduler と Cloud Run の間で認証情報をやり取りするために、Google Cloud のサービスアカウントを作成します。</li>
<li>サービスアカウントに Cloud Run Invoker の役割を付与し、Cloud Scheduler から Cloud Run サービスを呼び出す権限を与えます。</li>
</ol>



<h3>Cloud Run のセットアップ</h3>



<ol>
<li>Google Cloud コンソールにログインし、「Cloud Run」を開きます。</li>
<li>「サービスを作成」をクリックし、サービス名、リージョン、認証方法を設定します。</li>
<li>必要なアプリケーションのイメージをコンテナイメージとしてアップロードします。</li>
<li>必要に応じて、環境変数やメモリ制限などのコンテナの詳細設定をします。</li>
<li>全ての設定が完了したら、「デプロイ」をクリックしてサービスをデプロイします。</li>
<li>デプロイ後に表示される Cloud Run のエンドポイント URL をコピー・保存します。これは外部からサービスにアクセスするための URL です。</li>
</ol>



<h3>Cloud Scheduler のセットアップ</h3>



<ol>
<li>Cloud Scheduler コンソールにアクセスし、「ジョブの作成」ボタンをクリックします。</li>
<li>ジョブの設定を行い、トリガーとなるスケジュールを設定します。例えば、毎日午前 9 時にジョブを実行する場合は <code>0 9 * * *</code> という cron 構文を使用します。</li>
<li>Cloud Run サービスの URL を指定し、ジョブが実行されるときに HTTP リクエストがその URL に送信されるように設定します。</li>
<li>[Auth ヘッダー] リストでトークンタイプを選択します。通常は OIDC を使用しますが、<code>\*.googleapis.com</code> ホストの Google API は例外で OAuth（アクセス）トークンが使用されます。</li>
<li>[サービス アカウント] でクライアント サービス アカウントのメールアドレスを指定します。</li>
</ol>



<h2>まとめ</h2>



<p>以上で、Cloud Run と Cloud Scheduler の連携および認証設定が完了しました。これにより、Cloud Scheduler が定期的に Cloud Run のサービスを自動的にトリガーできます。</p>


Google Cloud サービス間の連携：Cloud Run と Cloud Scheduler

【Git初心者向け】ソースツリーを利用したGit操作について

Terraform の適切なディレクトリ構造について考える

Webデザイナーでも最低限覚えるべきJavaScpitと学習してみて思ったこと

Company

Our Solutions

Support

News

Blog

Blogブログ

カテゴリーから探す

年別から見る

記事一覧 - カテゴリー: 開発ナレッジ

2024/01/19

2024/01/05

2023/12/08

2023/11/24

2023/11/10

2023/10/20

2023/10/05

2023/09/22

2023/09/08

2023/08/25

2023/08/25

2023/07/28

2023/07/21

2023/06/24

2023/06/09

2023/05/27

2023/05/12

2023/03/16