Updating Replicated

To update your CircleCI Server installation, see our Upgrade Guide. This guide only runs through the steps required to update Replicated, not the CircleCI application.

前提条件

  • Ubuntu 14.04 または 16.04 ベースの環境を使用していること

  • お使いの環境が孤立して*おらず*、インターネットにアクセスできること.

  • We will be updating to Replicated v2.38, but first we need to check you are running at least v2.10.3 on your Services machine. To check this, SSH into the Services machine and run the following:

    replicated --version

    If you are running a version of Replicated pre 2.10.3 please reach out to support@circleci.com.

準備

Remember to take a snapshot (described here) before starting the Replicated update process
  1. Stop the CircleCI application by clicking the Stop Now button on the Dashboard. アプリケーションのシャットダウンには数分かかります。 Wait for the status to become “Stopped” before continuing.

    Stop the CircleCI Application
    Figure 1. Stop the CircleCI Application

    Alternatively you can SSH into the services machine and stop the CircleCI application from the command line:

    replicatedctl app stop

    You can check the status using the followng:

    replicatedctl app status inspect

    以下のように出力されます。

    [
        {
            "AppID": "edd9471be0bc4ea04dfca94718ddf621",
            "Sequence": 2439,
            "State": "stopped",
            "DesiredState": "stopped",
            "Error": "",
            "IsCancellable": false,
            "IsTransitioning": false,
            "LastModifiedAt": "2018-10-23T22:00:21.314987894Z"
        }
    ]
  2. For the replicated update to succeed, it is necessary to update docker to the recommended version, 17.12.1. Check which version you are running with docker version and if you need to update, follow these steps:

    sudo apt-get install docker-ce=17.12.1~ce-0~ubuntu
  3. 以下のコマンドを使用して Docker のバージョンを固定します。

    sudo apt-mark hold docker-ce

Perform Update

  1. 以下のように更新スクリプトを実行して、Replicated の更新を実行します。

    curl -sSL "https://get.replicated.com/docker?replicated_tag=2.38.6" | sudo bash

    Replicated と Docker の両方のバージョンをチェックしてください。

    replicatedctl version    # 2.38.6
    docker -v                # 17.12.1
  2. 以下のコマンドでアプリケーションを再起動します。

    replicatedctl app start

    アプリケーションのスピンアップには数分かかります。 以下のコマンドを実行するか、管理ダッシュボードにアクセスして進行状況を確認できます。

    replicatedctl app status inspect

    以下のように出力されます。

    [
        {
            "AppID": "edd9471be0bc4ea04dfca94718ddf621",
            "Sequence": 2439,
            "State": "started",
            "DesiredState": "started",
            "Error": "",
            "IsCancellable": true,
            "IsTransitioning": true,
            "LastModifiedAt": "2018-10-23T22:04:05.00374451Z"
        }
    ]


Help make this document better

This guide, as well as the rest of our docs, are open-source and available on GitHub. We welcome your contributions.