Skip to content

Commit

Permalink
Merge pull request #5 from annai-inc/lint-lagoonizing
Browse files Browse the repository at this point in the history
lagoonのドキュメントの日本語修正 金子担当箇所
  • Loading branch information
stqp authored Jul 23, 2024
2 parents 74ca5e6 + 57a668d commit 177a535
Show file tree
Hide file tree
Showing 10 changed files with 219 additions and 201 deletions.
16 changes: 8 additions & 8 deletions docs/ja/applications/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,36 +2,36 @@
説明: Lagoonで実行できるアプリケーション
---

# Lagoonがサポートするアプリケーション、フレームワーク、言語の幅広い範囲
# Lagoonは幅広いアプリケーション、フレームワーク、言語をサポートしています

Lagoonは、アプリケーションスタックの3つのレベルを大まかに分類しています:
Lagoonは、アプリケーションスタックを大きく3つのレベルに分類しています:

## 言語

これらは通常Lagoon特有のイメージによって提供され、任意のLagoonプロジェクトの基本的な構成要素です
Lagoonプロジェクトの基本的な構成要素であり、通常はLagoon専用のイメージによって提供されます

## フレームワーク

これらは基本イメージを取り、ウェブサイトを提供するため、またはアプリケーションを運用するために必要なロジック、ツール、パッケージを追加します。
これらの基本イメージを基に、ウェブサイトを提供したり、アプリケーションを駆動したりするために必要なロジック、ツール、パッケージを追加します。

## アプリケーション

通常、フレームワークの上に構築され、これはコンテンツエディターや開発者が最終製品を形成するために対話するレイヤーです
通常、フレームワークの上に構築され、コンテンツ編集者や開発者が最終製品を形作るために操作するレイヤーです

-----------------------

Lagoonで使用するためのリポジトリを参照するとき、通常は3つの方法でそれらを参照します:

## テンプレート

これらは完全に機能し、複製可能なスターターリポジトリであり、定期的に維持・更新され、少ないカスタマイズで拡張して使用することができます
これらは完全に機能する、クローン可能なスターターリポジトリです。定期的にメンテナンスと更新が行われ、わずかなカスタマイズで拡張して使用できる状態にあります

##

これらは完全に機能するリポジトリであり、定期的に維持・更新されますが、個々のプロジェクトに対して動作させるためにはいくつかの努力が必要かもしれません
これらは完全に機能するリポジトリで、定期的にメンテナンスと更新が行われていますが、個別のプロジェクトで動作させるにはある程度の労力が必要な場合があります

## デモ

これらはデモンストレーションとして構築されたリポジトリであり、その中のいくつかの概念に対して使用可能です。 しかし、定期的にメンテナンスや更新は行われていません
これらは実証のために構築されたリポジトリで、概念検証としては使用可能ですが、定期的なメンテナンスや更新は行われていません

より完全なリストについては、私たちのGitHubリポジトリ:[https://www.github.com/lagoon-examples](https://www.github.com/lagoon-examples) と私たちのウェブサイト [https://lagoon.sh/application/](https://lagoon.sh/applications/) をご覧ください。
15 changes: 15 additions & 0 deletions docs/ja/applications/laravel.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# LaravelをLagoonで実行

LaravelをLagoonで実行するには、複数の方法があります。

* 既存のアプリケーションを自分で「lagoonize」することができます([Lagoonizing](../lagoonizing/index.md)のドキュメントを参照してください)。
* 参考として、シンプルなlagoonizeされたLaravelインストールの例示リポジトリを用意しています。
* (推奨) ["Sail:onLagoon"](../other-tools/sail.md)というツールを提供しています。これは標準的なLaravel Sailアプリケーションを取り、適切なLagoon設定ファイルを自動生成します。

## アプリケーション環境キー

アプリケーションキーを設定するには、CLIまたはUIを通じて`APP_KEY`環境変数([environment variable](../concepts-advanced/environment-variables.md))を設定してください。

これにより、キーをコード内(例えば`.env`ファイル)に保存する必要がなくなります。

アプリケーションキーを生成するには、`php artisan key:generate --show`コマンドを実行してください。このコマンドはプロジェクトファイルを変更せずに、有効なキーを出力します。
4 changes: 2 additions & 2 deletions docs/ja/applications/node.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,6 @@

## はじめに

Lagoonは、[公式のNode Alpineイメージ](https://hub.docker.com/_/node/)を基にした[Node.jsイメージ](https://github.com/uselagoon/lagoon-images/tree/main/images/node)を提供しています。
Lagoonは、[公式のNode Alpineイメージ](https://hub.docker.com/_/node/)をベースにした[Node.jsイメージ](https://github.com/uselagoon/lagoon-images/tree/main/images/node)を提供しています。

Lagoon上でプロジェクトを動かすための適応方法についての詳しい情報は、[Node.js Dockerイメージ](../docker-images/nodejs.md)セクションで見つけることができます。
Lagoon上でプロジェクトを動かすための適応方法についての詳しい情報は、[Node.js Dockerイメージ](../docker-images/nodejs.md)セクションで見つけることができます。
20 changes: 10 additions & 10 deletions docs/ja/applications/options.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,45 +6,45 @@ description: Lagoonを使用するためのアプリケーション設定

## `lagoon.yml`

Lagoonのプロジェクトレベルおよび環境レベルの設定は、リポジトリの `.lagoon.yml` ファイルに提供されています
Lagoonのプロジェクトレベルおよび環境レベルの設定は、リポジトリの `.lagoon.yml` ファイルで提供されています

[`lagoon-yml.md`](../concepts-basics/lagoon-yml.md)を参照してください。

## `docker-compose.yml`

Lagoonのサービスレベルの設定は、リポジトリの`docker-compose.yml`ファイルに提供されています。特に、`lagoon.type`と関連するサービスラベルは個々のサービスで文書化されています
Lagoonのサービスレベルの設定は、リポジトリの`docker-compose.yml`ファイルで提供されています。特に、`lagoon.type`と関連するサービスラベルは、個々のサービスのドキュメントに記載されています

[`docker-compose-yml.md`](../concepts-basics/docker-compose-yml.md)を参照してください。

## ストレージ

Lagoonは、ほとんどのサービスにストレージを提供する能力があります - 組み込みのLagoonサービスタイプには、必要なPVC、ボリュームなどを追加するための`-persistent`バリアントがあります。この設定をローカルに反映するように例を更新しました
Lagoonはほとんどのサービスにストレージを提供する機能があります。Lagoon組み込みのサービスタイプには、必要なPVC、ボリュームなどを追加できる`-persistent`バリアントがあります。この設定をローカルで反映するように例を更新しました

## データベース

Lagoonは以下の設定を利用できます:
Lagoonは以下のデータベース設定に対応しています:

* Mariadb - すべてのサポートされているバージョン
* PostgreSQL - すべてのサポートされているバージョン
* Mariadb - サポートされている全バージョン
* PostgreSQL - サポートされている全バージョン

### データベース・アズ・ア・サービス

Lagoonはまた、[dbaas-operator](https://github.com/amazeeio/dbaas-operator)を利用して、これらのデータベースを自動的にプロビジョニングする能力もあります。 管理データベースサービス(例:RDS、Google Cloud Databases、Azure Database)があります。これらのサービスがクラスターにプロビジョニングされ、設定されると自動的にこれらが利用されます。これらが利用できない場合、フォールバックとしてポッドがプロビジョニングされます。
Lagoonはまた、[dbaas-operator](https://github.com/amazeeio/dbaas-operator)を利用して、基盤となるマネージドデータベースサービス(例:RDS、Google Cloud Databases、Azure Database)を使用してこれらのデータベースを自動的にプロビジョニングする機能を持っています。これらのサービスがクラスタ用にプロビジョニングおよび設定されると、自動的に行われます。これらが利用できない場合は、フォールバックとしてポッドがプロビジョニングされます。

## キャッシュ

Lagoonは、キャッシュバックエンドとしてRedisをサポートしています。本番環境では、一部のユーザーがスケールを助けるために、本番環境用の管理されたRedisサービスをプロビジョニングします
LagoonはキャッシュバックエンドとしてRedisをサポートしています。本番環境では、一部のユーザーがスケーリングを支援するために、マネージドRedisサービスをプロビジョニングしています

## 検索

Lagoonは、Elasticsearch、Solr、OpenSearchを検索プロバイダとしてサポートしています。必要に応じて、外部検索プロバイダも設定できます
Lagoonは検索プロバイダーとしてElasticsearch、Solr、OpenSearchをサポートしています。必要に応じて外部の検索プロバイダーも設定できます

## イングレス/ルート

Lagoonは、イングレス要件を持つサービスのルートを自動生成します。カスタムルートは、各サービスごとに `.lagoon.yml` に提供できます。

## 環境変数 { #environment-variables }

Lagoonは、ビルド時とランタイム時に環境変数を多用します。これらがアプリケーションの重要な設定(例:データベース設定/資格情報)を提供するために使用される場合、ローカルバージョンとLagoonバージョンが同様に名付けられていることが重要です
Lagoonは、ビルド時とランタイム時に環境変数を多用します。これらがアプリケーションの重要な設定(例:データベース設定/認証情報)を提供するために使用される場合、ローカルとLagoonのバージョンで同様の名前を付けることが重要です

詳細は [environment-variables.md](../concepts-advanced/environment-variables.md)を参照してください。
10 changes: 5 additions & 5 deletions docs/ja/applications/other.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# Lagoon上で他のアプリケーションを実行する
# Lagoonで他のアプリケーションを実行

たとえLagoonがあなたの特定のアプリケーション、フレームワーク、言語のための基本イメージを持っていなくても、Lagoonはそれを構築することができます!
Lagoonが特定のアプリケーション、フレームワーク、言語用のベースイメージを持っていなくても、Lagoonでビルドすることが可能です。

[共通イメージ](../docker-images/commons.md)を拡張したり、継承したりすることで、Lagoonはほぼどんなワークロードでも実行することができます
[commonsイメージ](../docker-images/commons.md)を拡張または継承することで、Lagoonはほぼあらゆるワークロードを実行できます

## Hugo

この簡単な例では、Hugoのウェブサイトを構築し、それをNGINXイメージの静的ファイルとして提供する方法を示しています。共通イメージはHugoの追加、サイトのコピー、構築のために使用されます。その後、NGINXイメージを使用してサイトを提供し、カスタマイズしたNGINX設定を追加します
この簡単な例は、Hugoウェブサイトをビルドし、NGINXイメージで静的ファイルとして提供する方法を示しています。commonsイメージを使用してHugoを追加し、サイトをコピーしてビルドします。その後、カスタマイズされたNGINX設定を追加したNGINXイメージを使用してサイトを提供します

```bash title="nginx.dockerfile"
FROM uselagoon/commons as builder
Expand All @@ -32,4 +32,4 @@ services:
dockerfile: lagoon/nginx.Dockerfile
labels:
lagoon.type: nginx
```
```
2 changes: 1 addition & 1 deletion docs/ja/applications/php.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# PHP

## 紹介
## はじめに

Lagoonは、[Drupal](./drupal/index.md)、Laravel、[Wordpress](wordpress.md)、Magento、Symfonyなど、様々なPHPベースのアプリケーションをサポートしています。

Expand Down
17 changes: 8 additions & 9 deletions docs/ja/applications/ruby.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,25 @@
# RubyとRuby on Rails

## 序章
## はじめに

私たちは、公式のRuby alpine Dockerイメージをベースに構築したRuby 3.0以上のイメージを提供しています。
私たちは、公式の Ruby alpine Docker イメージをベースにした Ruby 3.0 以上のイメージを提供しています。
以下では、Rails アプリを Lagoon にデプロイしようとしていることを前提としていますが、ここで説明する詳細の多くは実際にはフレームワークに依存しません。

以下では、Lagoon上でRailsアプリをデプロイしようとしていると仮定していますが、記述されている詳細のほとんどはフレームワークに関係なく適用可能です。

## Lagoon上でRailsを動作させる
## Lagoon で Rails を実行する

### リクエストへの応答

Lagoonの例のリポジトリにある[Ruby on Rails](https://github.com/lagoon-examples/ruby-on-rails)の例は、ここで参考になります
Lagoonの例のリポジトリにある[Ruby on Rails](https://github.com/lagoon-examples/ruby-on-rails)の例が参考になります

[`docker-compose.yml`](https://github.com/lagoon-examples/ruby-on-rails/blob/main/docker-compose.yml)では、`ruby`という名前のサービスを設定しています。これは、任意の動的リクエストを処理する主要なサービスです
[`docker-compose.yml`](https://github.com/lagoon-examples/ruby-on-rails/blob/main/docker-compose.yml)では、動的リクエストを処理する主要サービスとして`ruby`という名前のサービスを設定しています。

`ruby`サービス用に指定された[dockerfile](https://github.com/lagoon-examples/ruby-on-rails/blob/main/lagoon/ruby.dockerfile)を見てみると、ポート3000を公開していることがわかります。`nginx`サービスは、非静的アセットのリクエストをこのポートの`ruby`サービスにリダイレクトします(詳細は[nginx設定ファイル](https://github.com/lagoon-examples/ruby-on-rails/blob/main/lagoon/nginx/nginx.conf)を参照してください)。

### ロギング

Lagoonのロギングインフラストラクチャについては、次の文書で説明されています。 [こちらのドキュメント](../logging/logging.md)をご覧ください。基本的に、このインフラを利用するためには、ログをUDPメッセージで`udp://application-logs.lagoon.svc:5140`に送信する必要があります。

Railsの例では、`logstash-logger`というgemをインポートし、その後`config/application.rb`で以下のように初期化しています
Railsの例では、`logstash-logger`というgemをインポートし、その後`config/application.rb`で以下のように初期化しています

```ruby title="config/application.rb"
if ENV.has_key?('LAGOON_PROJECT') && ENV.has_key?('LAGOON_ENVIRONMENT') then
Expand All @@ -39,7 +38,7 @@ Railsの例では、`logstash-logger`というgemをインポートし、その

## データベース設定

この例では、私たちのPostgreSQLイメージを使用しています(`docker-compose.yml`ファイルを参照してください)。LagoonでのRailsを用いたデータベースアクセスの設定は非常に簡単です。Lagoonはデータベースのホスト、名前、資格情報を環境変数として注入するため、[`config/database.yml`](https://github.com/lagoon-examples/ruby-on-rails/blob/main/config/database これらのenv varsを認識し、存在する場合はそれらを利用するように.yml)を設定します
この例では、私たちのPostgreSQLイメージを使用しています(`docker-compose.yml`ファイルを参照してください)。LagoonでのRailsを用いたデータベースアクセスの設定は非常に簡単です。Lagoon はデータベース接続に必要な情報を環境変数として提供します。そのため、[`config/database.yml`](https://github.com/lagoon-examples/ruby-on-rails/blob/main/config/database) ファイルでこれらの環境変数を利用するように設定することで、簡単にデータベース接続を構成できます

```yaml title="config/database.yml"
default: &default
Expand Down
12 changes: 6 additions & 6 deletions docs/ja/applications/wordpress.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
# Lagoon上のWordPress
# WordPressをLagoonで実行

[WordPressテンプレート](https://www.github.com/lagoon-examples/wordpress-base)は、WordPress、その依存性、およびテーマをインストールするためにComposerを使用するように設定されています
[WordPressテンプレート](https://www.github.com/lagoon-examples/wordpress-base)は、Composerを使用してWordPress、その依存関係、およびテーマをインストールするように設定されています

WordPressテンプレートは[https://github.com/roots/bedrock](https://github.com/roots/bedrock)ボイラープレートを基にしていますが、標準化されたLagoonのデプロイメントパターンに合わせて拡張されています。
このWordPressテンプレートは[https://github.com/roots/bedrock](https://github.com/roots/bedrock)のボイラープレートをベースにしていますが、標準化されたLagoonのデプロイメントパターンに合わせて拡張されています。

## Composerインストール

テンプレートは、WordPressとそのテーマをインストールするためにComposerを使用します。
このテンプレートは、WordPressとそのテーマをインストールするためにComposerを使用します。

## データベース

LagoonはMariaDBとPostgreSQLデータベースをサポートしていますが、WordPressでのPostgreSQLのサポートは限定的なので、使用は推奨されません。

## NGINXの設定

LagoonにはWordPress用の組み込み設定がありません - 代わりに、テンプレートには[初期設定のnginx.conf](https://github.com/lagoon-examples/wordpress-base/tree/main/lagoon/nginx)が付属しています - あなたが見つけた改善点をぜひ投稿してください!
LagoonにはWordPress用の組み込み設定がありません - 代わりに、テンプレートには[初期設定のnginx.conf](https://github.com/lagoon-examples/wordpress-base/tree/main/lagoon/nginx)が付属しています。改善点があれば、ぜひ貢献してください!

## WP-CLI

Lagoonテンプレートは、WordPressのインストールを管理するために`wp-cli`をcliイメージにインストールします。
Lagoonテンプレートは、WordPressのインストールを管理するために`wp-cli`をcliイメージにインストールします。
Loading

0 comments on commit 177a535

Please sign in to comment.