Docker Scout 설치하기

Docker Scout 설치하기

Docker Scout CLI 플러그인은 Docker Desktop과 함께 사전 설치돼요.

Docker Desktop 없이 Docker Engine을 실행한다면 Docker Scout는 사전 설치되지 않지만, 독립형 바이너리로 설치할 수 있어요.

설치 스크립트 (Installation script)

플러그인의 최신 버전을 설치하려면 다음 명령을 실행하세요.

$ curl -fsSL https://raw.githubusercontent.com/docker/scout-cli/main/install.sh -o install-scout.sh
$ sh install-scout.sh

[!NOTE]

인터넷에서 다운로드한 스크립트는 로컬에서 실행하기 전에 항상 검토하세요. 설치 전에 편의 스크립트의 잠재적 위험과 제한 사항을 숙지하세요.

수동 설치 (Manual installation)

Linux

  1. 릴리스 페이지에서 최신 릴리스를 다운로드하세요.

  2. $HOME/.docker 아래에 scout라는 하위 디렉토리를 만드세요.

    $ mkdir -p $HOME/.docker/scout
    
  3. 아카이브를 추출하고 docker-scout 바이너리를 $HOME/.docker/scout 디렉토리로 옮기세요.

  4. 바이너리를 실행 가능하게 만드세요: chmod +x $HOME/.docker/scout/docker-scout.

  5. scout 하위 디렉토리를 플러그인 디렉토리로 .docker/config.json에 추가하세요.

    {
      "cliPluginsExtraDirs": [
        "/home/<USER>/.docker/scout"
      ]
    }
    

    <USER>를 시스템의 사용자 이름으로 바꾸세요.

    [!NOTE] cliPluginsExtraDirs의 경로는 절대 경로여야 해요.

macOS

  1. 릴리스 페이지에서 최신 릴리스를 다운로드하세요.

  2. $HOME/.docker 아래에 scout라는 하위 디렉토리를 만드세요.

    $ mkdir -p $HOME/.docker/scout
    
  3. 아카이브를 추출하고 docker-scout 바이너리를 $HOME/.docker/scout 디렉토리로 옮기세요.

  4. 바이너리를 실행 가능하게 만드세요.

    $ chmod +x $HOME/.docker/scout/docker-scout
    
  5. macOS에서 바이너리가 실행 가능하도록 승인하세요.

    xattr -d com.apple.quarantine $HOME/.docker/scout/docker-scout
    
  6. scout 하위 디렉토리를 플러그인 디렉토리로 .docker/config.json에 추가하세요.

    {
      "cliPluginsExtraDirs": [
        "/Users/<USER>/.docker/scout"
      ]
    }
    

    <USER>를 시스템의 사용자 이름으로 바꾸세요.

    [!NOTE] cliPluginsExtraDirs의 경로는 절대 경로여야 해요.

Windows

  1. 릴리스 페이지에서 최신 릴리스를 다운로드하세요.

  2. %USERPROFILE%/.docker 아래에 scout라는 하위 디렉토리를 만드세요.

    % mkdir %USERPROFILE%\.docker\scout
    
  3. 아카이브를 추출하고 docker-scout.exe 바이너리를 %USERPROFILE%\.docker\scout 디렉토리로 옮기세요.

  4. scout 하위 디렉토리를 플러그인 디렉토리로 .docker\config.json에 추가하세요.

    {
      "cliPluginsExtraDirs": [
        "C:\Users\<USER>\.docker\scout"
      ]
    }
    

    <USER>를 시스템의 사용자 이름으로 바꾸세요.

    [!NOTE] cliPluginsExtraDirs의 경로는 절대 경로여야 해요.

컨테이너 이미지 (Container image)

Docker Scout CLI 플러그인은 컨테이너 이미지로도 제공돼요. docker/scout-cli를 사용하면 호스트에 CLI 플러그인을 설치하지 않고도 docker scout 명령을 실행할 수 있어요.

$ docker run -it \
  -e DOCKER_SCOUT_HUB_USER=<your Docker Hub user name> \
  -e DOCKER_SCOUT_HUB_PASSWORD=<your Docker Hub PAT>  \
  docker/scout-cli <command>

GitHub Action

Docker Scout CLI 플러그인은 GitHub action으로도 제공돼요. GitHub 워크플로에서 사용해 push마다 이미지를 자동으로 분석하고 정책 준수를 평가할 수 있어요.

Docker Scout는 Jenkins, GitLab, Azure DevOps 같은 더 많은 CI/CD 도구와도 통합돼요. Docker Scout에 사용 가능한 통합(integrations)에 대해 자세히 알아보세요.