github.com/zaolin/u-root@v0.0.0-20200428085104-64aaafd46c6d/.circleci/images/README.md (about)

     1  # Circleci Images
     2  
     3  Each folder contains the Dockerfile for running integration tests with a
     4  different architecture.
     5  
     6  
     7  ## Build and Run
     8  
     9  The following examples assume two variables:
    10  
    11  - `$GOARCH`: the architecture
    12  - `$VERSION`: a "vX.Y.Z" string, a version which has not been used yet
    13    (ideally this follows semantic versioning).
    14  
    15  See previously built images at:
    16  
    17      https://hub.docker.com/r/uroottest/test-image-$GOARCH/tags
    18  
    19  Note: If `id | grep docker` contains no matches, your user is not a member of
    20  the docker group, so you will need to run each of the following `docker`
    21  commands with `sudo`.
    22  
    23  Build and run a new image:
    24  
    25      cd test-image-$GOARCH
    26      docker build . -t uroottest/test-image-$GOARCH:$VERSION
    27      docker run --rm -it uroottest/test-image-$GOARCH:$VERSION
    28  
    29  
    30  ## Push
    31  
    32  Push:
    33  
    34      # Ping Ryan O'Leary (on slack or via email) for push access.
    35      docker login
    36      docker push uroottest/test-image-$GOARCH:$VERSION
    37  
    38  Remember to update the image version in `.circleci/config.yml`.
    39  
    40  More instructions:
    41  
    42      https://circleci.com/docs/2.0/custom-images/
    43  
    44  
    45  ## Alternative Method
    46  
    47  With this new trick, there's no need to install Docker! Simply push a tag with
    48  the following name:
    49  
    50  - `test-image-$GOARCH-$VERSION`
    51  
    52  The new Docker image takes about 40 minutes to build and propagate.