
English: 
♪ (whimsical music) ♪
Hi, I'm Brent Beer,
with GitHub's training team.
Migrating your existing
GitHub Enterprise installation
to Amazon Web Services, or AWS,
lets you seamlessly deploy GitHub
within your existing production stack.
You've already invested time and resources
into your company's infrastructure.
Now you can run GitHub
in the environment you prefer.
In this video we're going
to take a look at the prerequisites
to getting your Enterprise instance
ready to make the migration,
how to transfer data from your machine
to your new AWS instance,
and how to restore your data
to pick up where you left off.
Before we migrate our on-premise instance
to Amazon Web Services, or AWS,
we want to ensure
that we're at the correct version
on our current instance.
The version that I have is 11.10.348.
The version we're looking for here
is at least a .344 at the end there,
upwards to .348.
We'll also want to decide in advance

Japanese: 
GitHubトレーニングチームの
ブレント・ビアです
既存のGitHub Enterprise設定を
Amazon Web Service (AWS)に
移動させます
GitHubをなめらかに
既存のプロダクションスタックに
デプロイしましょう
既に時間やリソースを
会社のインフラにつぎ込んでいますからね
お好みの環境で
GitHubを実行します
ここではEnterprise インスタンスの
マイグレーションに必要な
条件を確認し
新しいAWSインスタンスに
データを転送して
そしてデータを
中止したところで復元します
インスタンスを
Amazon Web Service (AWS)に
マイグレートする前に
まず現在のインスタンスの
正しいバージョンにいることを
確認します
私のバージョンは11.10.348.です
ここで必要なのは
少なくとも.344から.348であることです
トラフィックをどうやって転送するか

English: 
how we will transfer our traffic
to our new instance.
Please read our migration documentation,
to learn more about some of these options.
Once we are upgraded, we need to create
a backup host machine,
to create a snapshot
of our current instance,
that will later be used
to restore to our new AWS instance.
The reason for this backup
is because of some new infrastructure
that we've created on AWS,
as well as GitHub Enterprise 2.0.
To get started with this migration,
let's first create our backup,
by opening up our
Amazon Web Services console.
I have that open in a separate tab, here.
From here we can launch a new instance
by clicking the Launch Instance button.
I'm going to select an Ubuntu server here.
The type of instance I end up selecting
is going to be the same
as the default size of my
GitHub Enterprise on AWS instance
that I end up launching later.

Japanese: 
最初に決めておかなくてはなりません
これらのオプションについて
マイグレーションの
ドキュメントを読んで下さい
アップグレードしたら
バックアップホスト機を作る必要があります
現在のインスタンスの
スナップショットを作るのは
新しいAWSインスタンスを
復元するのにつかわれます
ここでバックアップを作るのは
AWSに作った新しいインフラが
GitHub Enterprise 2.0と同様だからです
このマイグレーションを始めるには
まずAWS コンソールを開いて
バックアップを取りましょう
別のタブで開きます
ここから新しいインスタンスを
ローンチできます
Launch Instance ボタンを
クリックする事で
Ubuntuサーバを選択します
最終的に選択するインスタンスのタイプは
あとでローンチする
AWS インスタンス上のGitHub Enterpriseの
初期サイズと同じです

English: 
There's no custom configuration
we need to do on this screen,
so let's skip to Add Storage.
The size of our instance here
should be large enough
for creating our snapshots
of our current instance.
I'm going to just set this to 60 GB.
Next we want to create
a human-readable name for this,
inside this tag.
So I will call this backup-host.
And, lastly, we have
a security group to make for this,
so that we can SSH into this machine.
Of course the SSH protocol is fine.
I'm going to rename this
to backup-host-ssh,
and describe this as
a group to SSH into backup host.

Japanese: 
カスタムコンフィグレーションを
このスクリーンで行う必要がないので
Add Storage はスキップしましょう
ここでインスタンスは現在のインスタンスの
スナップショットを作るだけの
十分な大きさである必要があります
60 GBに設定します
次に人が読むことのできる名前を
作ります
このタグ内に
backup-host と名付けましょう
最後にセキュリティグループを作り
このマシンにSSHができました
もちろんSSHプロトコルで結構です
これを ”backup-host-ssh”に
変更します
そしてこれを
"group to SSH into backup host"とします

Japanese: 
分かりやすい名前ですね
最後にステップを確認し
"Launch"をクリックします
これで"Creating an existing key pair"か
”Creating a new one.”を勧められます
新しい物を作って
"Backup machine"と
"Download that Key Pair"と呼びましょう
" Launch instance"をクリックして
このインストールを完了します
終わったら"View Instance"をクリックします
これでインスタンスがアップされます
”Public IP”を取得しましょう
画面の右下手です
それを"Copy"してクリップボードに貼り付けます
ターミナルウィンドウに
このマシンを[let's SSH into] します

English: 
That's a pretty descriptive name.
Lastly, we can review all these steps,
and click Launch.
This will prompt us
for Choose an existing key pair,
or Creating a new one.
I'm going to create a new one,
and call it Backup machine
and Download that Key Pair.
Lastly, we can click Launch instance,
to finish this installation,
and when we're all finished
we can click View Instance.
Now that our instance is up,
let's go ahead and grab that Public IP
in the lower right-hand corner
of the screen, here.
Copy that, put it on our clipboard,
and in a terminal window,
[let's SSH into] this machine.

Japanese: 
先に生成したSSH キーペアを使用して
IPアドレスを"ssh ubuntu@"して
このマシンに実装します
最初に行うのは
"rsync" がインストールされていることの確認です
”which rsync”でこれを行います
ここで分かります
次に"git"も同様にインストールできたことを確認します
"which git"を使用して
このレポジトリをクローンダウンできます
”git”がインストールできました
"rsync"と"git”がインストールできたので
SSH キーを作成して
カレントステータスに SSHして
バックアップ機に
バックアップすることができます
これには"ssh-keychain”を使用します

English: 
We're going to ssh ubuntu@
that IP address,
and then use the SSH key pair
that I had generated earlier
to get onto this machine.
So the first thing we want to do
is check that we have rsync installed.
We could do that with
which rsync.
We see that we have it, there.
Next, we need to ensure
that git is installed, as well,
so that we can even
clone down this repository,
that with which git.
We see that we have git installed.
Now that we have
both rsync and git installed,
let's generate an SSH key
so that we can SSH
into our current instance,
to create that backup
on this backup machine.
We're going to use
ssh-keychain to do this.

English: 
The type of this SSH key
is going to be an rsa.
We want a descriptive name there,
so that when we're viewing this key
we can know which key it actually is.
Let's go ahead and save that
in the default location,
and have no passphrase for this.
And now that we have that generated,
we can go back to our
GitHub Enterprise instance,
our .348 instance,
and upload this SSH key.
Let's cat out that SSH key,
so that we can copy it,
and then upload it to that machine.
Cut this.

Japanese: 
このタイプのSSH keyは"rsa"です
記述名をつけます
そうするとキーを見れば
どのキーかが実際にわかります
デフォルトロケーションで保存しましょう
パスフレーズはありません
これで生成できたので
GitHub Enterprise インスタンスへ戻れます
.348 インスタンスです
このSSH keyをアップロードします
SSH キーを"cat" アウトして
コピーしてからマシンにアップロードします
"Cut" して下さい

Japanese: 
開いていた元のタブをクリックバックして
もちろん GitHubか　
アドミ アカウントでサインインし
”Admin tools” に進んだら
左にある"Management console"へ進みましょう
右上にある

”Settings”をクリックし
"Add this new SSH key"をペーストして

”Add key”　をクリック

キーがアッドされたら
ボトムまでスクロールできます
"Save settings" を行うには
インスタンスを設定しましょう

この設定はSSH キーがセットされたことを
確認するためのものです
実行中にターミナルへ戻り

English: 
Go ahead and click back to
that original tab that we had open,
of course signed in as a GitHub--
or as our Administrator account, here.
Go to the Admin tools,
and the Management console,
here on the left.
I'm going to click over on the Settings,
in the upper right-hand portion,
and Add this new SSH key
by pasting this in.
Click Add key.
Once that key's been added
we can scroll to the bottom,
to Save settings,
and reconfigure the instance.
This reconfiguring is just going
to make sure that SSH key is set.
♪ (lounge music) ♪
While that's running, let's go ahead
and go back to our terminal

Japanese: 
”backup-utils” コピーを入手します
レポジトリへ行きましょう
"backup-utils" レポジトリを使い

バックアップスナップショットを作ります
一度セットアップしたインスタンスを
リストアするのと同じです
バックアップホストを得るために

レポジトリのURL をコピーし

マシンにクローンしておきます
このレポジトリの"README" は
ステーブルブランチを提示します
”-b stable” はこのクローン内です

English: 
to get a copy of backup-utils.
Let's go ahead and visit that repository.
the backup-utils repository
is going to be used
for creating these backup snapshots,
as well as restoring to our new instance
once we have that set up.
To get this on my backup host,
I'm going to copy the URL
of this repository
and clone that down to my machine.
♪ (lounge music) ♪
The README of this repository
suggests being on the stable branch,
thus the -b stable
mention there, in that clone.

Japanese: 
そのダイレクトリに”cd” を行い
"backup.config”を編集します
これで現在のインスタンスを
ポイントできます
まず必要なのは

現在のインスタンスの 
IP アドレスを入手することです
"backup.config" ファイルを編集して

現在のインスタンスに
バックアップをポイントできます

戻ってこれを行います
これでSSH キー設定が完了です

あとで続きをやります

このIP アドレスをコピーして下さい
"backup.config-example”を

"backup.config" 上に"Copy"して

"backup.config" を開き
"GHE_HOSTNAME"を


English: 
Let's cd into that directory,
and edit our backup.config
so that we can point it
to our current instance.
♪ (lounge music) ♪
First thing that we'll have to do
is grab the IP address
of our current instance.
We'll need to edit the backup.config file
so that we can point our backup utility
to this current instance.
So let's go over and do that.
We see that the SSH key
setup has finished.
Go back to that later.
Copy that IP address.
We're going to want to Copy
the backup.config-example,
over to backup.config,
and open up backup.config,
and change the GHE_HOSTNAME

English: 
to the name,
rather the IP address,
for current instance.
Now that we've added
that IP address into that variable,
let's run the ghe-host-check,
verify that connection works,
and, lastly, start an initial backup.
Now, while this backup
runs the first time,
it's going to take a little bit longer
than the incremental backups
we'll see later,
but we'll go ahead and create
an initial snapshot now,
and let that run,
and fire up our new
GitHub Enterprise instance.
So we'll get that started...
While that's running,
let's go ahead and go over
to our enterprise.github.com account,
and go visit the Downloads page.
What's on this page?
We're going to go ahead
and select GitHub on AWS,

Japanese: 
IPアドレスではなく

名前に変えて下さい
これでIPアドレスを変数に加えました

"ghe-host-check" を実行しましょう
このコネクションが機能するのを
確認して下さい
最後にイニシャルバックアップをします
このバックアップをすると

あとで見ていく増分バックアップよりも
少し時間が長くかかります
最初のスナップショットを作成してから
実行して
新しいGitHub Enterprise インスタンスを
始動させます
開始しました・・・

その実行中に

"enterprise.github.com" アカウントの

”Downloads” ページを訪れましょう
このページは何でしょうか？

右側のオプションで


English: 
in this right-side option, here.
And the region we're going to select
is going to be a region
different than where
our backup is currently stored.
This is for general
disaster-recovery best practices.
♪ (lounge music) ♪
Once we have selected that region,
we're presented with
an AMI ID for that region.
We also maybe want to download
a new software license.
This will be easily accessible
when we launch that new instance on AWS,
we can re-upload the license to it there.
So let's go ahead and Download.
Let's grab that ID,
put it onto our clipboard,
go back to our Management Console tab
that we still have open.
We're going to change regions here
to the region which
that AMI ID corresponds to.

Japanese: 
"GitHub on AWS" を選択します
ここで選択するリージョンは

現在保存されている
バックアップとは異なります
リカバリには一番いい方法です
リージョンを選択すると

このリージョンのAMI ID が
表示されます

新しいライセンスをDL しましょう

AWS上の新しいインスタンスに
ローンチした際に

アクセスしやすくなります
ここにライセンスを再度アップロードできます

"Download" します

ID を得たら

これはクリップボードに貼っておき
開いてあるManagement Console
タブに戻ります
ここでAMI ID が対応するリージョンに
リージョン変更をします

Japanese: 
新しい ”Instance” を”Launch”して
インスタンスIDのCommunity AMIs
を検索します
"Enter" を入力

出てきたAMI を"Select"します
インスタンスのデフォルトサイズは
"r3.large"である必要があります
このインスタンスには
カスタム設定がありませんが
次のストレージスクリーンにはあります
Git ユーザデータに
"Add a New Volume"が必要です
12 GB に設定します

少なくとも10 GB は必要です

分かりやすい名前を付けて
インスタンスにタグ付けを行います

"ghe-aws" としましょう
セキュリティグループを選択し


English: 
From here we're going
to Launch new Instance,
and search the Community AMIs
for that instance ID.
Go ahead and hit Enter.
Select the AMI that is shown.
The default size of this instance
should be r3.large.
There won't be any custom configuration
on this instance, as well,
but on the next screen,
for storage,
we do need to Add a New Volume
for Git user data.
This is going to be set to 12 GB,
and we recommend at least 10 GB.
Next, we want to tag the instance
with a name that makes sense to us,
and is easily identifiable.
I'm going to call this ghe-aws.
Lastly, we want to choose some security groups

Japanese: 
情報とトラフィックを制御して

インスタンスに到達します

”ghe-aws” というグループが
既にあります

カスタムポートについては

”Help”ドキュメントでお読み下さい
最後に追加した設定を
確認して
準備出来たら"Launch"を
クリックします
"choose an existing key pair"あるいは
”create a new key pair” を指示されます
新しいものをここで作成し

"ghe-aws" と呼びましょう

"Download" クリック
これで必要だった
SSH がマシンに使えます
”Launch instance” クリック
インスタンスがアップされて
間もなく実行されます

English: 
so we can control information and traffic
to reach our instance.
I have an existing group for this already,
called ghe-aws.
It has a number of custom ports
that you can read about
in our Help documentation.
The last step of this will be to review
these settings that we've added,
and when we're ready,
we can click Launch.
We'll be prompted
to choose an existing key pair
or to create a new key pair.
I'm going to create a new one here,
and just also call this ghe-aws,
and click Download.
This will allow us to SSH
into that machine,
should we ever need to.
Go ahead and click Launch instance.
That instance should be up and running
in just a few moments.
♪ (lounge music) ♪

English: 
Now that that instance
is in the running state,
we're going to grab
that Public IP address,
and open a new tab to visit my instance.
We're again shown this SSL warning.
This is just going to let us know
that we have
a self-signed SSL certificate.
If we needed to verify
the authenticity of this
we can follow the steps below.
Let's go ahead and click
Continue to setup.
We Continue past the SSL prompt.
To finish this installation,
we need to upload our license file,
so click the link,
and select the github-enterprise.ghl
that we downloaded
when we started this process.
And Finish the Installation.
We need to also create a password
that'll allow us to get into
the Management Console
as well as the API.
We should use some sort
of password generator to create this,

Japanese: 
これでインスタンスは実行状態です
この"Public IP" アドレスを入手して

新しいタブでインスタンスを訪れます
またもやSSL 警告です
これで―
自己署名SSL 認証が
あることがわかります
認証する必要がある時は
次のように進みます
"Continue to setup" をクリックします
SSL プロンプトを”Continue” します
ライセンスファイルをアップロードして
インストールを完了します
リンクをクリックし
この過程を始めた際にダウンロードした
"github-enterprise.ghl" 選択します

そして "Installation" を"Finish"します
API と同様に

Management コンソールに
入るための
パスワードも用意します
作成にはパスワード生成機を使い

English: 
to allow everyone to see this password
who needs access
to the Management Console and API.
Click Save Password once
you have that password generated.
At this point we need
to choose our install type.
For this video, we're going to be
migrating some data
into this installation.
Click Migrate here.
To allow our backup machine
access to our new instance,
in order to restore that data,
we need to upload its SSH key, here.
So let's go back to that terminal window.
We see that previous backup has finished.
We're going to cat out the id.rsa.pub
that we generated earlier,

Japanese: 
"Management Console"と
APIにアクセスする人が
このパスワードを見られるようにします
パスワードが生成されたら
"Save Password” をクリックします

ここでインストール方法を選択します
このビデオではいくつかデータを
インストールに
マイグレーションします
ここで”Migrate”をクリック

バックアップ機が新しい
インスタンスにアクセスして
データを復元するには
このSSH キーをアップロードします
ターミナルウィンドウへ戻ります

これで先のバックアップが完了しました
先に生成した"id_rsa.pub"を
"cat"します

English: 
and we're going to paste this
into our new instance.
Go in and add that key,
and click Continue.
The final step of this process
is to run the ghe-restore command.
But before we do that we should
make one additional snapshot
of our current instance,
after we put it in maintenance mode.
We're going to put the current instance
in maintenance mode
so that we can ensure that
no additional data is written to it
when we make that last snapshot.
Go ahead and click
Enable maintenance mode.
We see that there's no processes running,
so we can be ensured
that no one is working
on this instance at this time.
Now that Maintenance mode is in progress,
let's Enable that last backup.
Run that backup one more time
to finish making sure that
any additional work that was done

Japanese: 
そして新しいインスタンスに貼り付けます
キーをアッドして
"Continue"をクリック
最後は "ghe-restore"
コマンドの実行です

その前にメンテナンスモードに入れた後
現在のインスタンスの
スナップショットを作ります
メンテナンスモードに
現在のインスタンスを入れて
データが追加されていないことを確認
最後のスナップショットです
”Enable maintenance mode" を
クリックすると
何も進行がないので
誰もこのインスタンスで
作業していない事を確認できます
"Maintenance mode" が進行中です
最後のバックアップを"Enable" しましょう
バックアップを再び実行して
新しいインスタンスを設定した間に

Japanese: 
追加作業が終了していることを確認します
これで最新バックアップに記録しました
これで完了です
”ghe-restore" コマンドをグラブして
新しい AWS インスタンスに復元します
ここではただ”Copy” して
"Paste" コマンドで
Safari ウィンドウからグラブしました
ポート122 を自動検出して
これでコネクションがOKだとわかり
最新のバックアップを復元し始めます

English: 
while we were configuring
our new instance
is now recorded in our
last, latest backup.
♪ (up-tempo lounge music) ♪
Now that that's finished,
we can grab that ghe-restore command
to restore it to that new AWS instance.
I'm just going to Copy this,
Paste that command that we grabbed
from our Safari window in.
We'll see that the connection was OK,
in that it auto-detected to port 122,
and it'll begin to restore
that latest backup.

Japanese: 
これで完了です
ウィンドウに戻ります
復元が”Complete” したことがわかります
準備出来たら"Continue" をクリック
ここで設定を確認すると
SSH キーがアップロードされています
他の追加設定も確認できます
以前のインスタンスにあった設定も
同様に移行されています
初めてこの設定をしたので
最後に"Save settings" をクリックして
インスタンスを設定します
ちょっとスピードアップしましょう
このデモを進行できます
これでEnterprise インスタンスが
準備できました
古いインスタンスから新しいインスタンスへ
始めに選択したお好みの方法で
ネットワークトラフィックを切り替えます

English: 
Now that that's finished,
we can revisit that window,
see that the restore status
of this is Complete,
and click Continue when we're ready.
We can review our settings here,
see that the SSH key is already uploaded.
We can verify any other
additional settings
that we had on our previous instance
have been brought over, as well.
Lastly, we're going
to click Save settings.
This will configure our instance,
since we're creating some
of these settings for the first time.
Let's go ahead and speed this up,
so we can move forward with this demo.
Now that our Enterprise instance is ready,
we can go ahead
and switch our network traffic
from our old instance
to this new instance,
using whichever method we chose earlier.

English: 
When viewing this instance,
right away we can see
that our repository data was brought over,
in that restore process.
Let's go ahead and Sign in
to verify our account.
Using the same user name and credentials
that I had on my previous instance,
click Sign in.
You can see that I'm now signed in,
in the upper right-hand corner.
Congratulations!
You've upgraded your instance
to GitHub Enterprise 2.0 on AWS.
The primary steps of this process were:
establishing a backup host,
and backing up the prior
GitHub Enterprise instance,
then establishing a new
GitHub Enterprise 2.0 instance,
and restoring our data to it.
This step-by-step guide
will give you confidence and clarity
in your own upgrade
to this exciting new version
of the GitHub Enterprise platform.
Thanks for watching this episode
on Migrating GitHub Enterprise
to Amazon Web Services.

Japanese: 
このインスタンスを見ると
リストアプロセスでレポジトリデータが
移行したのがわかります
"Sign in" へ進みアカウントを認証します
以前のインスタンスと同じユーザ名と
パスワードを使い
"Sign in" をクリック
右上でサインインしたのがわかります
お疲れ様でした！
インスタンスをAWS上に
GitHub Enterprise 2.0 にアップグレードしました
このプロセスでは:

backup ホストを作り
GitHub Enterprise インスタンスの
バックアップを行い
新しいGitHub Enterprise 2.0 
インスタンスを設置し
そしてデータをリストアします
このステップごとのガイドで
GitHub Enterprise プラットホームを
自信を持って更新できますね
GitHub Enterprise の
AWSマイグレーションの
ご視聴ありがとうございました

Japanese: 
GitHub Enterprise を
AWS に移動する事で
貴社は最高のソフトウェアを
最高のソフトウェアインフラに設置できます

English: 
By moving to GitHub Enterprise on AWS,
your company will have
the best way to build software
on the best software infrastructure.
♪ (music finale) ♪
