Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

「Continuous Deployment with Travis」を翻訳 #763

Merged
merged 6 commits into from
Dec 9, 2023

Conversation

monyatto
Copy link
Contributor

@monyatto monyatto commented Dec 1, 2023

Issue

概要

Continuous Deployment with Travisのページを日本語に翻訳しました。

スクリーンショット

screenshot


### What is this Continuous Deployment thing?
### 継続的デプロイとは何でしょうか?
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

こちらの段落について17行目以外は以下のガイドと説明が共通しているため、訳文を合わせていただいても良いでしょうか?🙇🏻‍♀️
https://railsgirls.jp/continuous


###Github, Travis CI and anynines
### Github、Travis CIとanynines
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nits:

Travis CIとanynines

【Travis CI】で一つの意味をなしていると思います。「CIとanynines」と単語同士がくっついていて「Travis」が離れているため、以下のように半角スペースが入っていても良さそうだなと思いました。

Travis CI と anynines


The first thing we need is an app in a Github repository. And we have just that! Next you'll need to make sure you followed the guide on how to deploy your app via anynines until the very last step.
まずGithubにリポジトリが必要です。私たちには既にそれがありますね!次にanyninesを使ってデプロイする方法のガイドを最後の手順まで終えたことを確認してください。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

must:

The first thing we need is an app in a Github repository.

Githubリポジトリではなく「Githubリポジトリ内のアプリケーション」を指していると思います👀
訳文の見直しをお願いします。

And we have just that! Next you'll need to make sure you followed the guide on how to deploy your app via anynines until the very last step.

こちらもapp が訳文から抜けてしまっています。

anyninesを使ってアプリをデプロイする

nits:

you followed the guide

followed が使われているため「ガイドに従って」などとしても良さそうです👍


Then, we need to create a file called `manifest.yml` in the main directory of your app, so we can save some information about the deployment there. In your terminal run:
それから、アプリのメインディレクトリに`manifest.yml`という名前のファイルを作成していきましょう。そこにデプロイについての情報を保存することができます。ターミナルで以下のコマンドを実行してください。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nits:
need が使われているため「作成していきましょう」よりも「作成する必要があります」の方が良いかなと個人的に感じました👀

so we can save some information about the deployment there.

so が使われているため、接続詞として「これにより」などがあっても良さそうです👀
また、some information となっているため「いくつかの情報」としても良いかなと思いました。


{% highlight sh %}
cf push
{% endhighlight %}

This will trigger a first deployment to anynines. The cf gem will notice that there is no `manifest.yml` and will ask you a standard set of configuration questions such as the desired number and memory size of your app instances, whether and which services to bind to them and most importantly, whether you want to store this information.
Please answer this question with a 'hell yes' as it will create the desired `manifest.yml` file!
これはanyninesへの最初のデプロイの引き金になります。cf gemは`manifest.yml`が無いことを確認すると、基本的な設定に関する質問をしてきます。 例えば、あなたのアプリインスタンスで希望する数とメモリサイズ、どのサービスをバインドするかどうかなどについてです。中でもとりわけ重要な質問はこれらの情報を保存するかということです。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nits:

This will trigger a first deployment to anynines.

cf push とはanyninesにアプリをデプロイするアプリをデプロイする際に打つコマンドで、ガイドに従ってこのコマンドを実行すると初回デプロイがもたらされるという意図かなと思われます。
「引き金」とするよりも前後の繋がりをみて

これにより、anyninesへの初回デプロイが開始されます。

とちょっと意訳しちゃっても良いかなと思いました👍

基本的な設定に関する質問

構成に関する質問になるため「基本的」ではなく「標準的」でも良さそうだなと思いました👍

This will trigger a first deployment to anynines. The cf gem will notice that there is no `manifest.yml` and will ask you a standard set of configuration questions such as the desired number and memory size of your app instances, whether and which services to bind to them and most importantly, whether you want to store this information.
Please answer this question with a 'hell yes' as it will create the desired `manifest.yml` file!
これはanyninesへの最初のデプロイの引き金になります。cf gemは`manifest.yml`が無いことを確認すると、基本的な設定に関する質問をしてきます。 例えば、あなたのアプリインスタンスで希望する数とメモリサイズ、どのサービスをバインドするかどうかなどについてです。中でもとりわけ重要な質問はこれらの情報を保存するかということです。
希望するmanifest.ymlファイルを作成するために、この質問には「yes」と答えてください!
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nits:

'hell yes'

ただのyesではなくhellがついているため、「もちろん」などの日本語が良さそうだなと思いました。
ターミナルではYなどを打つかもですが、ここではyesと回答することを強調してそうです。


Once your push was successful, you should be able to access your application using a browser of your choice, which means your are ready to setup Travis!
一度pushが成功すると、あなたのブラウザを使ってアプリにアクセスできるようになります。以上でTravisをセットアップする準備ができました!
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

must:

you should be able to access your application using a browser of your choice,

your choice が抜けてしまっています👀


For now we don't have 'real tests', so we will go ahead and create a Travis configuration file that will fake a succeeding test suite. Please go to your local app directory and create a ``.travis.yml`` file. At the moment, paste the following content. We’ll add some more information later on, using the Travis gem.
今の私たちには「‘real tests’」がありません。そのため次の手順では成功したテストスイートを偽造するTravisの設定ファイルを作成しましょう。まずローカル環境でアプリのディレクトリまで移動し、``.travis.yml``ファイルを作成してください。作成したファイルに次の内容を貼り付けてください。後ほどTravis gemを使って情報を追加します。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

must:

今の私たちには「‘real tests’」がありません。

reall tests は「実際のテスト」などと訳すのはどうでしょうか?

nits:

そのため次の手順では成功したテストスイートを偽造するTravisの設定ファイルを作成しましょう。

「偽造」より「模倣」などの方が説明として自然かなと感じました👀

成功するテストスイートを模倣するTravisの設定ファイルを作成します。

とするのはどうでしょうか?

must:

At the moment, paste the following content.

At the moment とあるため、「現時点では」があった方が良さそうです👍


{% highlight sh %}
language: ruby
script: 'true'
{% endhighlight %}

Your app now contains the Travis configuration but how should Travis know when to pull your code from Github and trigger test execution? This is where Github hooks come into play!
これでアプリにTravisの設定が含まれるようになりましたが、TravisはGithubからあなたのコードを引っ張ってきて、テストを実行するタイミングをどのように知るのでしょうか?ここでGithubフックの出番です!
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nits:

コードを引っ張ってきて

「取得して」の方が良さそうだなと思いました👀


{% highlight sh %}
git add .
git commit -m "test Travis integration"
git push origin master
{% endhighlight %}

Now we can configure the actual deployment.
Let's use the travis gem:
実際のデプロイを設定できるようになりました。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nits:
Nowが使われているため、「さて」などの接続詞があっても良さそうです👍

{% highlight sh %}
gem install travis
{% endhighlight %}

Now use the `travis` command to setup the anynines deployment.
`travis`コマンドを使用して、anyninesデプロイをセットアップできます。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nits:

travisコマンドを使用して、anyninesデプロイをセットアップできます。

anyninesへのデプロイを設定するために`travis`コマンドを使ってみましょう。

「できます」よりもコマンドを使ってみましょうと促す表現の方が流れとして読みやすそうかなと思いました👀

{% highlight sh %}
cf target
{% endhighlight %}

to gather all information required for Travis setup. This includes target url, username, the organization and space you are currently using. You can also take a look-see at the welcome mail you have received after signing up at anynines.com.
Travisのセットアップに必要なすべての情報を収集します。これには、ターゲットURL、ユーザー名、現在使用している組織とスペースが含まれます。anynines.comへのサインインが完了した後にウェルカムメールも届くでしょう。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

must:

signing up

とあるので「サインアップ」が適切そうです👍


After the `travis` command has finished, your ``.travis.yml`` should look somewhat like this:
`travis`コマンドが終了後、`.travis.yml`は以下のようになります。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nits:
「終了後」よりも「完了後」の方が良いかなと思いました👍

should look somewhat like this:

この部分を日本語にも含ませると良さそうです!
「おおよそ」などを付け加えるのはどうでしょうか?

これらはTravisを使った継続的デプロイの準備が完了したことを示しています!
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

must:

This means your are done and good to go!

この文章は上の説明に対してかかっていると読み取りました👀

なので継続的デプロイの準備が整ったことではなく、デプロイ作業が完了して繰り返し作業が問題なくできることを意味しているんじゃないかと感じました。

これは、作業が完了していて問題なく進めることを意味します!

みたいな訳文はいかがでしょうか?

@maimux2x
Copy link
Collaborator

maimux2x commented Dec 2, 2023

@monyatto
翻訳のご協力ありがとうございます🙌✨
色々コメントをつけていますが、

  • mustは見直しをお願いします
  • nitsは私の主観込みなため修正するかはお任せします

の基準で読んでいただけると幸いです🙏
引き続きよろしくお願いします〜!

@monyatto
Copy link
Contributor Author

monyatto commented Dec 4, 2023

@maimux2x
ご指摘ありがとうございます! 修正が完了したので再度ご確認お願いします🙏

{% highlight sh %}
cf target
{% endhighlight %}

to gather all information required for Travis setup. This includes target url, username, the organization and space you are currently using. You can also take a look-see at the welcome mail you have received after signing up at anynines.com.
Travisのサインアップに必要なすべての情報を収集します。これには、ターゲットURL、ユーザー名、現在使用している組織とスペースが含まれます。anynines.comへのサインインが完了した後にウェルカムメールも届くでしょう。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

signing up がまだ「サインイン」のままになっているため、「サインアップ」へ修正をお願いします🙇🏻‍♀️

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

すみませんこちら漏れていました! 修正完了しました🙏

@maimux2x
Copy link
Collaborator

maimux2x commented Dec 6, 2023

@monyatto
何度もすみません🙇🏻‍♀️
Gemfile.lockが含まれてしまっているため除いていただいても良いでしょうか?

@monyatto
Copy link
Contributor Author

monyatto commented Dec 7, 2023

@maimux2x
こちらこそ失礼しました……! Gemfile.lockを除いたのでご確認お願いします🙏

Copy link
Collaborator

@maimux2x maimux2x left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@monyatto
ご対応ありがとうございました!
LGTMです✨

@maimux2x maimux2x merged commit 02ddaec into railsgirls-jp:master Dec 9, 2023
2 checks passed
@monyatto
Copy link
Contributor Author

@maimux2x
大変お手数おかけしました🙇🏻
ご確認ありがとうございます!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants