github.com/alloyci/alloy-runner@v1.0.1-0.20180222164613-925503ccafd6/docs/install/linux-repository.md (about)

     1  # Install AlloyCI Runner using the official AlloyCI repositories
     2  
     3  We provide packages for the currently supported versions of Debian, Ubuntu, Mint, RHEL, Fedora, and CentOS.
     4  
     5  | Distribution | Version | End of Life date   |
     6  | ------------ | ------- | ------------------ |
     7  | Debian       | buster  |                    |
     8  | Debian       | stretch | approx. 2022       |
     9  | Debian       | jessie  | June 2020          |
    10  | Debian       | wheezy  | May 2018           |
    11  | Ubuntu       | artful  |                    |
    12  | Ubuntu       | zesty   | January 2018       |
    13  | Ubuntu       | xenial  | April 2021         |
    14  | Ubuntu       | trusty  | April 2019         |
    15  | Mint         | sonya   | approx. 2021       |
    16  | Mint         | serena  | approx. 2021       |
    17  | Mint         | sarah   | approx. 2021       |
    18  | Mint         | rosa    | April 2019         |
    19  | Mint         | rafaela | April 2019         |
    20  | Mint         | rebecca | April 2019         |
    21  | Mint         | qiana   | April 2019         |
    22  | RHEL/CentOS  | 7       | June 2024          |
    23  | RHEL/CentOS  | 6       | November 2020      |
    24  | Fedora       | 25      |                    |
    25  | Fedora       | 26      |                    |
    26  
    27  ## Prerequisites
    28  
    29  If you want to use the [Docker executor], make sure to install Docker before
    30  using the Runner. [Read how to install Docker for your distribution](https://docs.docker.com/engine/installation/).
    31  
    32  ## Installing the Runner
    33  
    34  To install the Runner:
    35  
    36  1. Add AlloyCI's official repository:
    37  
    38      ```bash
    39      # For Debian/Ubuntu/Mint
    40      curl -L https://packagecloud.io/install/repositories/alloyci/alloy-runner/script.deb.sh | sudo bash
    41  
    42      # For RHEL/CentOS/Fedora
    43      curl -L https://packagecloud.io/install/repositories/alloyci/alloy-runner/script.rpm.sh | sudo bash
    44      ```
    45  
    46      >**Note:**
    47      _Debian users should use APT pinning_
    48      >
    49      Since Debian Stretch, Debian maintainers added their native package
    50      with the same name as is used by our package, and by default the official
    51      repositories will have a higher priority.
    52      >
    53      If you want to use our package you should manually set the source of
    54      the package. The best would be to add the pinning configuration file.
    55      Thanks to this every next update of the Runner's package - whether it will
    56      be done manually or automatically - will be done using the same source:
    57      >
    58      ```bash
    59      cat > /etc/apt/preferences.d/pin-alloy-runner.pref <<EOF
    60      Explanation: Prefer AlloyCI provided packages over the Debian native ones
    61      Package: alloy-runner
    62      Pin: origin packagecloud.io
    63      Pin-Priority: 1001
    64      EOF
    65      ```
    66  
    67  1. Install the latest version of AlloyCI Runner, or skip to the next step to
    68     install a specific version:
    69  
    70      ```bash
    71      # For Debian/Ubuntu/Mint
    72      sudo apt-get install alloy-runner
    73  
    74      # For RHEL/CentOS/Fedora
    75      sudo yum install alloy-runner
    76      ```
    77  
    78  1. To install a specific version of AlloyCI Runner:
    79  
    80      ```bash
    81      # for DEB based systems
    82      apt-cache madison alloy-runner
    83      sudo apt-get install alloy-runner=1.0.0
    84  
    85      # for RPM based systems
    86      yum list alloy-runner --showduplicates | sort -r
    87      sudo yum install alloy-runner-1.0.0-1
    88      ```
    89  
    90  1. [Register the Runner](../register/README.md)
    91  
    92  After completing the step above, the Runner should be started already being
    93  ready to be used by your projects!
    94  
    95  Make sure that you read the [FAQ](../faq/README.md) section which describes
    96  some of the most common problems with AlloyCI Runner.
    97  
    98  ## Updating the Runner
    99  
   100  Simply execute to install latest version:
   101  
   102  ```bash
   103  # For Debian/Ubuntu/Mint
   104  sudo apt-get update
   105  sudo apt-get install alloy-runner
   106  
   107  # For RHEL/CentOS/Fedora
   108  sudo yum update
   109  sudo yum install alloy-runner
   110  ```
   111  ## Manually download packages
   112  
   113  You can manually download the packages from the following URL:
   114  <https://packagecloud.io/alloyci/alloy-runner/>
   115  
   116  [docker executor]: ../executors/docker.md