アトラシアンに大きなファイルを転送する方法

このドキュメントでは、アトラシアンの転送ファイル サーバーを使用してファイルを転送する方法を説明します。一般的に、これは技術サポートのプロセスで複雑な課題のトラブルシューティング中に生じます。

We have a few ways to upload large files. The first one is Atlassian's file service, transfer.atlassian.com, allows for the direct transmission of files to Atlassian through a web browser. The second one is command line tool for resumable file upload. This document will explain how and when you should use any of these approaches.

このページの内容

Atlassian's file service

  • We recommend you to use resumable file upload for files more than 20GB or when you have unstable internet connection. If you need to use transfer.atlassian.com then compress and/or split very large files. See how to compress a file and how to split a file for more info.

  • For downloading files more than 1GB we recommend using wget or CURL(should be > 7.7.1) with retries. See how to download a large file for more info.

  • You can transfer the file via your browser, or via the command line using the REST API. We recommend using your browser for the file no more than 1GB, otherwise use the command line.

  • This document assumes you have an open support request.  See How to gain access for more info on how to log in.

  • Files that were attached to a support issue will be removed in 60 days after resolving the support issue in accordance with Support File Retention Policy.

To transfer a file via your browser:

  1. In your browser, go to transfer.atlassian.com. Follow the prompts to log in using your Atlassian account. 

  2. Your open support requests will be listed. Choose Add Attachments



  3. プロンプトに従ってファイルをアップロードします。



  4. 転送が正常に完了したら、リストされているファイル サイズがファイルのローカル コピーのサイズと一致することを確認します。



  5. アップロードが必要な各ファイルで手順 2 と 3 を繰り返します。
  6. Your support.atlassian.com issue will be updated each time a file has been uploaded. Once all your files have been uploaded, add a comment to your support ticket to let the support engineer know you're done uploading files. 

To transfer a file using via the command line:

  1. After logging in to transfer.atlassian.com, choose Auth Tokens in the header to generate an authentication token. 

  2. Use the example CURL command generated by filling the auth token you generated and your file access path to upload your file to this ticket as follows:

    curl -u NWMzNzcwY:xyz123 -X POST --header "Transfer-Encoding: chunked" \
        -F "files[]=@/var/atlassian/confluence/export/Confluence_support_2017-10-12-13-29-42.zip" \
        -F "files[]=@/var/atlassian/confluence/export/thread_dumps.zip" \
        https://transfer.atlassian.com/api/upload/PS-12345 -v --progress-bar | tee /dev/null

 transfer.atlassian.com is available for all of your open cases, so you can use it at any time

Resumable file upload 

  1. Download repository.
  2. Open README and follow the instruction.
  3. 転送が正常に完了したら、リストされているファイル サイズがファイルのローカル コピーのサイズと一致することを確認します。

How to download a large file 

If you need to download a large file (>1GB), you will need to use wget or CURL with retries. Copy your file download link from transfer.atlassian.com and use the script as follows:


The following commands will download a file via a HTTP request wget or CURL. You can use any value of retries depending on your internet connection. The optimal value is 250.

$ wget 'https://api.media.atlassian.com/file/0f5b9527-6d46-4d60-85d8-4f2bd164e666 \
/binary?token=token&client=89838f12-f13o-4b52-8f6c-fb55c95dfee6&collection=3547771&dl=true' \
-O filename --tries=250
$ curl 'https://api.media.atlassian.com/file/0f5b9527-6d46-4d60-85d8-4f2bd164e666 \
/binary?token=token&client=89838f12-f13o-4b52-8f6c-fb55c95dfee6&collection=3547771&dl=true' \
-o filename --retry 250

How to get access

If you need to transfer a large file or files to Atlassian, you will need to first create a support request at support.atlassian.com. Once you've created a request, you'll be able to log in to transfer.atlassian.com and upload files against your support issue. 

How to compress data

帯域幅の使用率を最小化するために、ファイルを .ZIP、.GZ、または .TAR.GZ ファイルに圧縮します。(これは大きなファイルの転送中に接続が切れる機会を最小限に抑えるのにも役立ちます。)

Linux

Linux では、この目的で次の tar コマンドを使用するとうまくいきます。

$ tar czf ~/jiradb.tar.gz ~/jiradb
Windows または Mac

Windows または OS X では、フォルダーを右クリックすると圧縮メニューが表示されます。

How to split data into smaller pieces

Although transfer.atlassian.com has a file size limit 50GB, we recommend limiting files to 1GB in size. This minimizes the window of opportunity for the upload process to fail, and, (in case of a failed upload,) minimizes the time spent re-uploading the same information multiple times.

Linux または Mac

split コマンドを使用すると、ファイルを指定したサイズの複数のセグメントに分割できます。以下の例では、圧縮された "jiradb" ファイルはサイズが 1GB 以下の複数のセグメントに分割されます。

$ split -b 1073741824 ~/jiradb.tar.gz jiradb.tar.gz_
$ ls -l | grep jira
-rw-r--r--    1 user  staff  1073741824 Mar 27 12:03 jiradb.tar.gz_aa
-rw-r--r--    1 user  staff  1073741824 Mar 27 12:03 jiradb.tar.gz_ab
-rw-r--r--    1 user  staff   412536832 Mar 27 12:03 jiradb.tar.gz_ac

The "-b" argument specifies the maximum file size of each segment in bytes. (1073741824 bytes = 1GB) ~/jiradb.tar.gz is the input filename, and jiradb.tar.gz_ is the output filename. By default, the split command appends a two letter code to the end of the specified output filename to indicate the order of the segments. In this case, specifying the "jiradb.tar.gz_" filename resulted in the following sequential segments: jiradb.tar.gz_aa, jiradb.tar.gz_ab, and jiradb.tar.gz_ac. All three of these files will need to be uploaded to transfer.atlassian.com.

オペレーティング システムのドキュメントをよく読んで、このツールを正しく使用できるようにしてください。

ファイルをマージ/結合するには、以下の例を参考にしてください。

$ cat jiradb.tar.gz_* > jiradb.tar.gz
$ tar -cvvzf jiradb.tar.gz .

Windows

HJ-Split の分割機能を使用する


最終更新日 2021 年 11 月 2 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.