Skip to content

Commit

Permalink
docs: translation cleanup - ongoing
Browse files Browse the repository at this point in the history
  • Loading branch information
tobybellwood committed Jun 14, 2024
1 parent e773142 commit 0e98eb5
Show file tree
Hide file tree
Showing 69 changed files with 377 additions and 359 deletions.
45 changes: 26 additions & 19 deletions docs/ja/README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,37 @@
# ラグーン
# Lagoon

![](./lagoon-logo.png)

## ラグーン - Kubernetes向けのオープンソースアプリケーションデリバリープラットフォーム
## Lagoon - Kubernetes向けのオープンソースアプリケーションデリバリープラットフォーム { #lagoon-the-open-source-application-delivery-platform-for-kubernetes }

ラグーンは開発者が夢見るものを提供します。それは開発者がローカル環境と本番環境でまったく同じコードを実行することを可能にするシステムです。同じDockerイメージ、同じサービス設定、そして同じコード。
Lagoonは開発者が夢見るものを提供します。それは開発者がローカル環境と本番環境でまったく同じコードを実行することを可能にするシステムです。同じDockerイメージ、同じサービス設定、そして同じコード。

## どこから始めればいいですか?
## どこから始めればいいですか? { #where-do-i-start }

あなたがラグーンを使用してウェブサイトやアプリケーションをホストしたい場合は、[ラグーンの基本的な使い方](using-lagoon-the-basics/index.md)を参照してください。
あなたがLagoonを使用してウェブサイトやアプリケーションをホストしたい場合は、[Lagoonの基本的な使い方](using-lagoon-the-basics/index.md)を参照してください。

ラグーンの機能についてより深く理解するためには、[ラグーンの高度な使い方](using-lagoon-advanced/index.md)をご覧ください。
Lagoonの機能についてより深く理解するためには、[Lagoonの高度な使い方](using-lagoon-advanced/index.md)をご覧ください。

ラグーンの仕組みを理解するためには、[ラグーンの概念 - 基本](concepts-basics/index.md)をチェックしてください。
Lagoonの仕組みを理解するためには、[Lagoonの概念 - 基本](concepts-basics/index.md)をチェックしてください。

そして、より深い理解のために、[ラグーンの概念 - 高度](concepts-advanced/index.md)をご覧ください。
そして、より深い理解のために、[Lagoonの概念 - 高度](concepts-advanced/index.md)をご覧ください。

あなたがラグーンを開発したい(機能を追加、バグを修正)場合は、[ラグーンの開発](contributing-to-lagoon/developing-lagoon.md)をご覧ください。
あなたがLagoonを開発したい(機能を追加、バグを修正)場合は、[Lagoonの開発](contributing-to-lagoon/developing-lagoon.md)をご覧ください。

## TL;DR: ラグーンの仕組み
## TL;DR: Lagoonの仕組み { #tldr-how-lagoon-works }

1. 開発者は必要なサービスをYAMLファイル内で定義し、設定します。
2. 満足したら、コードをGitにプッシュします。
3. ラグーンはYAMLファイルを解析し、必要な追加設定を追加します。
4. ラグーンは必要なDockerイメージをビルドします。
5. Translation request timed out. Lagoonは主にNode.jsで構築されています。これは最初にNode.jsを使い始めたからだけでなく、Node.jsがwebhooks、タスクなどの非同期処理を可能にするからです。一部のサービスのプログラミング言語を変更することを考えています。これがマイクロサービスの素晴らしいところです!他のプラットフォームの部分を心配することなく、一つのサービスを別の言語で置き換えることができます。
1. 開発者は、YAML ファイル内で必要なサービスを定義および構成します。
2. 満足したら、コードを Git にプッシュします。
3. Lagoon は YAML ファイルを解析し、必要な追加構成を追加します。
4. Lagoon は必要な Docker イメージを構築します。
5. Lagoon はそれらを Docker レジストリにプッシュします。
6. Lagoon は Kubernetes に必要なリソースを作成します。
7. Lagoon はコンテナの展開を監視します。
8. すべてが完了すると、Lagoon はさまざまな方法 (Slack、メール、Web サイトなど) で開発者に通知します。

## Lagoonについて { #a-couple-of-things-about-lagoon }
1. **Lagoon はマイクロサービスに基づいています**。デプロイメントとビルドのワークフローは非常に複雑です。複数のバージョン管理ソース、複数のクラスター、複数の通知システムがあります。各デプロイメントは一意であり、数秒から数時間かかる場合があります。柔軟性と堅牢性を考慮して構築されています。マイクロサービスはメッセージング システムを介して通信するため、個々のサービスをスケールアップおよびスケールダウンできます。これにより、個々のサービスのダウンタイムを乗り切ることができます。また、他の部分に影響を与えることなく、本番環境で Lagoon の新しい部分を試すこともできます。
2. **Lagoon では多くのプログラミング言語が使用されています**。各プログラミング言語にはそれぞれ固有の長所があります。私たちは、各サービスに最も適した言語を決定するよう努めています。現在、Lagoon の多くは Node.js で構築されています。これは最初にNode.jsを使い始めたからだけでなく、Node.jsがwebhooks、タスクなどの非同期処理を可能にするからです。一部のサービスのプログラミング言語を変更することを考えています。これがマイクロサービスの素晴らしいところです!他のプラットフォームの部分を心配することなく、一つのサービスを別の言語で置き換えることができます。
3. **LagoonはDrupal特有のものではありません**。すべてが任意のDockerイメージを実行できるように構築されています。Drupal用の既存のDockerイメージがあり、DrushのようなDrupal特有のツールもサポートしています。しかし、それだけです!
4. **LagoonはDevOpsです**。開発者が必要なサービスを定義し、必要に応じてカスタマイズすることができます。これが正しい方法でないと思うかもしれませんし、開発者にあまりにも多くの権限を与えていると思うかもしれません。しかし、私たちはシステムエンジニアとして、開発者を強化する必要があると考えています。開発者がローカルでサービスを定義し、それらをローカルでテストすることを許せば、彼ら自身がバグやミスを見つけるでしょう。
5. **LagoonはDockerとKubernetes上で動作します。** \(それは明らかですよね?\)
Expand All @@ -34,18 +41,18 @@

私たちはあなたがLagoonのインフラストラクチャとサービスがどのように連携して動作するかを理解することを望んでいます。ここにスキーマがあります(少し古く、最近追加したサービスやKubernetesをカバーしていないので、更新作業中です!):[Lucid Chart](https://lucid.app/documents/view/cb441054-e04a-4389-b98b-c75bcda8ea0d)

## Lagoonの歴史
## Lagoonの歴史 { #history-of-lagoon }

説明したように、Lagoonは夢が実現したものです。amazee.ioでは、Drupalを8年以上ホストしてきました。これは私たちのホスティングプラットフォームの4回目の大きな改訂です。3回目の改訂はPuppetとAnsibleを中心に構築されました。プラットフォームの各部分は全て設定管理で行われました。これにより新しいサーバーの設定が非常に速くできましたが、同時に開発者のカスタマイズの余地が不足していました。私たちはいくつかのカスタマイズを実装しましたが、すでにDockerを本番環境で使用していました。しかし、私たちは決して それに完全に満足していました。我々は、既存のプラットフォームだけでは足りないと気づきました。分離型Drupalの台頭、サーバーサイドでのNode.jsの動作要求、Elasticsearchへの要望、異なるSolrバージョンなど、我々はもっと進める必要がありました。

同時に、私たちは長年にわたり、ローカル開発のためにDockerを使用してきました。プロダクションで全てをDockerで行うというのは常に考えていました。唯一の問題は、ローカル開発とプロダクション環境間の接続でした。他にも、プロダクションでDrupalをDockerで動作させるシステムが存在します。しかし、ローカルとプロダクションで正確に同じイメージとサービスをテストすることを許可するものは何もありませんでした。

Lagoonは2017年に誕生しました。それ以来、プロダクションでDockerを動作させるシステムに発展しました。Lagoonは、我々の第3世代のホスティングプラットフォームを、最先端の全Dockerベースのシステムに置き換えました。

### オープンソース
### オープンソース { #open-source }

amazee.ioでは、オープンソースを信じています。Drupalのようなオープンソースコードが独占的なホスティングプラットフォームでホストされていることは常に我々にとって問題でした。ホスティング会社の強さと成功は、単にデプロイメントシステムやサービスの設定だけではありません。それはプラットフォームを動かす人々と知識です。 プロセス、スキル、予期しない状況に対応する能力、そして最後に忘れてはならないのは、彼らがクライアントに提供するサポートです。

### ライセンス
### ライセンス { #license }

Lagoonは、[`Apache 2.0 ライセンス`](https://github.com/uselagoon/lagoon/blob/main/LICENSE)の下で利用可能です。
Lagoonは、[`Apache 2.0 ライセンス`](https://github.com/uselagoon/lagoon/blob/main/LICENSE)の下で利用可能です。
4 changes: 2 additions & 2 deletions docs/ja/applications/drupal/drush-9.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: >-
ラグーンはデフォルトでDrush 8を使用します。Composerを使ってDrush 9をDrupalサイトにインストールすると、Drush 9が使用されます。
LagoonはデフォルトでDrush 8を使用します。Composerを使ってDrush 9をDrupalサイトにインストールすると、Drush 9が使用されます。
---

# Drush 9
Expand Down Expand Up @@ -66,4 +66,4 @@ drush rsync @lagoon.main:%files @self:%files -- --omit-dir-times --no-perms --n

リモートからローカル環境へ`rsync`する場合、これは必要ありません。

また、私たちは[Drushのメンテナと協力して](https://github.com/drush-ops/drush/issues/3491)、これを自動的に注入する方法を見つけ出そうとしています。
また、私たちは[Drushのメンテナと協力して](https://github.com/drush-ops/drush/issues/3491)、これを自動的に注入する方法を見つけ出そうとしています。
46 changes: 19 additions & 27 deletions docs/ja/applications/drupal/first-deployment-of-drupal.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@

![excited](https://i.giphy.com/media/7kVRZwYRwF1ok/giphy-downsized.gif)

## 1. すべてが準備できていることを確認してください
## 1. すべてが準備できていることを確認してください { #1-make-sure-you-are-all-set }

初回のデプロイメントを成功させるためには、あなたの[DrupalプロジェクトがLagoon化されている](../../using-lagoon-the-basics/setup-project.md)ことと、Lagoonでプロジェクトが設定されていることを確認してください。そうでない場合でも心配はいりません![ステップバイステップガイド](./step-by-step-getting-drupal-ready-to-run-on-lagoon.md)を参照して作業方法を確認してください。

## 2. プッシュ
## 2. プッシュ { #2-push }

Lagoonでは、デプロイするために設定されたブランチにプッシュすることで新しいデプロイメントを作成します。

Expand All @@ -27,11 +27,11 @@ git push

また、Lagoon UIをチェックして、任意のデプロイメントの進行状況を確認することもできます(Lagoonの管理者が情報を持っています)。

## 3. 失敗
## 3. 失敗 { #3-a-fail }

`.lagoon.yml`で定義されたポストロールアウトタスクにより、`drush updb``drush cr`のようなタスクを実行したかもしれません。これらのDrushタスクは、環境内に存在しているデータベースに依存していますが、明らかにまだ存在していません。それを修正しましょう!読み進めてください。

## 4. ローカルデータベースをリモートのLagoon環境に同期する
## 4. ローカルデータベースをリモートのLagoon環境に同期する { #4-synchronize-local-database-to-the-remote-lagoon-environment }

LagoonではフルのDrushサイトエイリアスをサポートしているため、ローカルデータベースをリモートのLagoon環境と同期することができます。

Expand Down Expand Up @@ -65,16 +65,15 @@ drush sql-sync @self @develop

```bash title="Drush sql-syncの結果"
[drupal-example]cli-drupal:/app$ drush sql-sync @self @develop
ssh.lagoon.amazeeio.cloud/drupalのデータが破壊され、drupalからのデータで置き換えられます。
本当に続行しますか? (y/n): y
ソースのデータベースダンプを開始します。 [ok]
データベースダンプは/home/drush-backups/drupal/20180227075813/drupal_20180227_075815.sql.gzに保存されました。 [success]
デスティネーションで一時ファイルディレクトリを検出します。 [ok]
[email protected]:/tmp/drupal_20180227_075815.sql.gzのファイルを削除し、/home/drush-backups/drupal/201802270からのデータで置き換えます。 75813/drupal_20180227_075815.sql.gz
本当に続行しますか? (y/n): y
ソースからデスティネーションへのダンプファイルのコピー。 [ok]
デスティネーションデータベースにダンプファイルのインポートを開始します。

You will destroy data in ssh.example.com/drupal and replace with data from drupal.
Do you really want to continue? (y/n): y
Starting to dump database on Source. [ok]
Database dump saved to /home/drush-backups/drupal/20180227075813/drupal_20180227_075815.sql.gz [success]
Starting to discover temporary files directory on Destination. [ok]
You will delete files in [email protected]:/tmp/drupal_20180227_075815.sql.gz and replace with data from /home/drush-backups/drupal/20180227075813/drupal_20180227_075815.sql.gz
Do you really want to continue? (y/n): y
Copying dump file from Source to Destination. [ok]
Starting to import dump file onto Destination database.
```

さて、再度デプロイを試してみましょう。今度は空のプッシュです:
Expand All @@ -92,7 +91,7 @@ git push

それでも失敗する場合は、ログリンクを確認して詳細情報を得てください。

## 5. ローカルファイルをリモートのLagoon環境に同期する
## 5. ローカルファイルをリモートのLagoon環境に同期する { #5-synchronize-local-files-to-the-remote-lagoon-environment }

おそらく推測できたでしょう:Drushでそれを行うことができます:

Expand All @@ -104,20 +103,13 @@ drush rsync @self:%files @develop:%files

```bash title="Drush rsync results"
[drupal-example]cli-drupal:/app$ drush rsync @self:%files @develop:%files
ファイルを削除します [email protected]:/app/web/sites/default/files内のデータを/app/web/sites/default/files/からデータで置き換えます。
本当に続行しますか? (y/n): y

しかし、場合によっては、ここでのように正しく見えないことがあります:

```bash title="Drush rsync results"
[drupal-example]cli-drupal:/app$ drush rsync @self:%files @develop:%files
あなたは[email protected]:'/app/web/%files'内のファイルを削除し、'/app/web/%files'からのデータで置き換えます。
本当に続行しますか? (y/n):
You will delete files in [email protected]:/app/web/sites/default/files and replace with data from /app/web/sites/default/files/
Do you really want to continue? (y/n): y
```

その理由は、Drupalがファイルディレクトリのパスを解決できないからです。これはおそらく、Drupalが完全に設定されていないか、データベースが欠けているためです。回避策としては`drush rsync @self:sites/default/files @develop:sites/default/files`を使用できますが、ローカルとリモートのDrupalを実際に確認することをお勧めします(`drush status`でファイルディレクトリが正しく設定されているかどうかをテストできます)。

## 6. 完了しました
## 6. 完了しました { #6-its-done }

Lagoonがビルドとデプロイを完了すると、チャットシステムに2回目の通知を送信します。以下のような感じです:

Expand All @@ -132,11 +124,11 @@ Lagoonがビルドとデプロイを完了すると、チャットシステム

以上です!それが難しすぎなければよいのですが、私たちはDevOpsを使いやすくすることを目指しています。

## しかし、他のブランチや本番環境はどうですか?
## しかし、他のブランチや本番環境はどうですか? { #but-wait-how-about-other-branches-or-the-production-environment }

それがLagoonの美点です:まったく同じです。本番ブランチとして定義したブランチ名をプッシュすると、そのブランチがデプロイされます。

## 失敗?心配しないで
## 失敗?心配しないで { #failure-dont-worry }

デプロイメントが失敗しましたか?ああ、それは大変です!でも、私たちは助けるためにここにいます:

Expand Down
2 changes: 1 addition & 1 deletion docs/ja/applications/drupal/services/nginx.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[Lagoonの`nginx-drupal` Dockerイメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/nginx-drupal/Dockerfile)。Drupalと連携するように最適化されています。[Lagoonの`nginx`イメージ](../../../docker-images/nginx.md)に基づいています。

## ラグーンの適応
## Lagoonの適応

このイメージは、Lagoonで使用するために準備されています。したがって、すでにいくつかのことが行われています:

Expand Down
Loading

0 comments on commit 0e98eb5

Please sign in to comment.