• ローカルストレージの使用
• オブジェクトストレージの使用
• オブジェクトストレージの設定
  • S3互換接続設定
  • Oracle Cloud S3接続設定
  • OpenStack互換の接続設定

アップロード管理

アップロードは、GitLabに単一のファイルとして送信することができるすべてのユーザーデータを表します。 例として、アバターやノートの添付ファイルはアップロードです。 アップロードはGitLabの機能に不可欠であるため、無効にすることはできません。

ローカルストレージの使用

アップロードがローカルに保存される場所を変更するには、以下の手順に従ってください。

オムニバスのインストールで：

アップロードはデフォルトで/var/opt/gitlab/gitlab-rails/uploadsに保存されます。

1. 例えばストレージパスを/mnt/storage/uploadsに変更するには、/etc/gitlab/gitlab.rb を編集し、以下の行を追加します：

   gitlab_rails['uploads_storage_path'] = "/mnt/storage/"
   gitlab_rails['uploads_base_dir'] = "uploads"
   

2. ファイルを保存し、変更を有効にするために GitLab を再設定します。

ソースからのインストールで：

アップロードはデフォルトで/home/git/gitlab/public/uploads/-/systemに保存されます。

1. 保存パスを例えば/mnt/storage/uploadsに変更するには、/home/git/gitlab/config/gitlab.yml を編集し、以下の行を追加または修正します：

   uploads:
     storage_path: /mnt/storage
     base_dir: uploads
   

2. ファイルを保存し、GitLabを再起動して変更を有効にします。

オブジェクトストレージの使用

注:

• GitLab Premium10.5で導入されました。
• GitLab Core10.7 で導入されました。
• バージョン 11.1 以降、S3 への direct_upload をサポートしています。

GitLab がインストールされているローカルディスクをアップロードの保存に使いたくない場合は、代わりに AWS S3 のようなオブジェクトストレージプロバイダを使うことができます。 この設定は、有効な AWS 認証情報がすでに設定されていることに依存します。

GitLabでのオブジェクトストレージの使用についてはこちらをご覧ください。

オブジェクトストレージの設定

ソースのインストールでは、以下の設定はuploads: の下にネストされ、次にobject_store:となります。Omnibus GitLab のインストールでは、これらの設定の前にuploads_object_store_が付きます。

S3互換接続設定

接続設定はフォグが提供するものと同じで、以下の通りです：

オムニバスのインストールで：

アップロードはデフォルトで/var/opt/gitlab/gitlab-rails/public/uploads/-/systemに保存されます。

1. /etc/gitlab/gitlab.rb を編集し、以下の行を必要な値に置き換えて追加します：

   gitlab_rails['uploads_object_store_enabled'] = true
   gitlab_rails['uploads_object_store_remote_directory'] = "uploads"
   gitlab_rails['uploads_object_store_connection'] = {
     'provider' => 'AWS',
     'region' => 'eu-central-1',
     'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
     'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
   }
   

   注意:AWS IAMプロファイルを使用している場合は、AWSアクセスキーとシークレットアクセスキー/値のペアを必ず省略してください。

   gitlab_rails['uploads_object_store_connection'] = {
     'provider' => 'AWS',
     'region' => 'eu-central-1',
     'use_iam_profile' => true
   }
   

2. ファイルを保存し、変更を有効にするために GitLab を再設定します。
3. gitlab:uploads:migrate Rakeタスクを使って、既存のローカルアップロードをオブジェクトストレージに移行します。

ソースからのインストールで：

アップロードはデフォルトで/home/git/gitlab/public/uploads/-/systemに保存されます。

1. /home/git/gitlab/config/gitlab.yml を編集し、以下の行を追加または修正してください：

   uploads:
     object_store:
       enabled: true
       remote_directory: "uploads" # The bucket name
       connection:
         provider: AWS # Only AWS supported at the moment
         aws_access_key_id: AWS_ACESS_KEY_ID
         aws_secret_access_key: AWS_SECRET_ACCESS_KEY
         region: eu-central-1
   

2. ファイルを保存し、GitLabを再起動して変更を有効にします。
3. gitlab:uploads:migrate Rakeタスクを使って、既存のローカルアップロードをオブジェクトストレージに移行します。

Oracle Cloud S3接続設定

Oracle Cloud S3は以下の設定を必ず使用する必要があることに注意してください：

enable_signature_v4_streaming がtrueに設定されている場合、以下のエラーが表示されることがあります：

STREAMING-AWS4-HMAC-SHA256-PAYLOAD is not supported

OpenStack互換の接続設定

接続設定はフォグが提供するものと同じで、以下の通りです：

オムニバスのインストールで：

アップロードはデフォルトで/var/opt/gitlab/gitlab-rails/public/uploads/-/systemに保存されます。

1. /etc/gitlab/gitlab.rb を編集し、以下の行を必要な値に置き換えて追加します：

   gitlab_rails['uploads_object_store_remote_directory'] = "OPENSTACK_OBJECT_CONTAINER_NAME"
   gitlab_rails['uploads_object_store_connection'] = {
    'provider' => 'OpenStack',
    'openstack_username' => 'OPENSTACK_USERNAME',
    'openstack_api_key' => 'OPENSTACK_PASSWORD',
    'openstack_temp_url_key' => 'OPENSTACK_TEMP_URL_KEY',
    'openstack_auth_url' => 'https://auth.cloud.ovh.net/v2.0/',
    'openstack_region' => 'DE1',
    'openstack_tenant' => 'TENANT_ID',
   }
   

2. ファイルを保存し、変更を有効にするために GitLab を再設定します。
3. gitlab:uploads:migrate Rakeタスクを使って、既存のローカルアップロードをオブジェクトストレージに移行します。

ソースからのインストールで：

アップロードはデフォルトで/home/git/gitlab/public/uploads/-/systemに保存されます。

1. /home/git/gitlab/config/gitlab.yml を編集し、以下の行を追加または修正してください：

   uploads:
     object_store:
       enabled: true
       direct_upload: false
       background_upload: true
       proxy_download: false
       remote_directory: OPENSTACK_OBJECT_CONTAINER_NAME
       connection:
         provider: OpenStack
         openstack_username: OPENSTACK_USERNAME
         openstack_api_key: OPENSTACK_PASSWORD
         openstack_temp_url_key: OPENSTACK_TEMP_URL_KEY
         openstack_auth_url: 'https://auth.cloud.ovh.net/v2.0/'
         openstack_region: DE1
         openstack_tenant: 'TENANT_ID'
   

2. ファイルを保存し、変更を有効にするために GitLab を再設定します。
3. gitlab:uploads:migrate Rakeタスクを使って、既存のローカルアップロードをオブジェクトストレージに移行します。