솔루션 튜토리얼 시작하기

솔루션 튜토리얼은 IBM Cloud를 사용하여 우수 사례 및 검증된 기술을 기반으로 일반적인 패턴을 구현하는 방법에 대한 단계별 지시사항을 제공합니다.

이 안내서는 튜토리얼 콜렉션을 진행하기 전에 이 콜렉션에 있는 안내서의 지시사항을 따르도록 개발 환경을 설정하는 데 도움을 줍니다.

목표

IBM Cloud와 함께 생산성을 높이기 위해 다음과 같은 필수 도구를 설치하십시오.

  • IBM Cloud CLI - IBM Cloud API와 상호작용하기 위한 명령행 인터페이스입니다.
  • Docker - 컨테이너라고 하는 패키지로 소프트웨어를 제공하고 실행합니다.
  • kubectl - Kubernetes 클러스터에 대한 명령을 실행하기 위한 명령행 인터페이스입니다.
  • oc - OpenShift 애플리케이션을 관리하고 시스템의 각 컴포넌트와 상호작용하기 위한 도구를 제공합니다.
  • Helm 3 - Kubernetes 애플리케이션 관리를 도와줍니다. Helm Charts는 가장 복잡한 Kubernetes 애플리케이션을 정의하고, 설치하고, 업그레이드하는 데 도움을 줍니다.
  • Terraform - 리소스 프로비저닝을 자동화합니다.
  • jq - 경량의 유연한 명령행 JSON 프로세서입니다.
  • Git - 무료로 제공되는 오픈 소스 분산 버전 제어 시스템입니다.

이러한 도구의 설치를 방지하기 위해 IBM Cloud 콘솔에서 Cloud Shell 를 사용할 수도 있습니다.

Microsoft Windows

다음 절에서는 관리자 권한이 있는 사용자가 Microsoft Windows 10 64비트를 실행 중이라고 가정합니다. 특정 절을 완료하고 나면 모든 운영 체제에 공통되는 구성으로 진행하십시오.

IBM Cloud CLI

  1. https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest 에서 IBM Cloud CLI를 다운로드하여 설치하십시오.

  2. 다음 명령을 사용하여 설치를 확인하십시오.

    ibmcloud version

    설치 후 머신을 다시 시작해야 할 수 있습니다.

Docker

  1. Docker Desktop on Windows는 Windows에서 컨테이너 이미지를 실행하는 한 가지 옵션입니다. 설치를 진행하기 전에 라이센스 계약의 이용 약관을 검토하십시오.

  2. 계정이 없으면 https://hub.docker.com/signup 에서 무료 계정에 가입하십시오.

  3. https://docs.docker.com/docker-for-windows/install/ 에서 Docker Desktop on Windows를 다운로드하여 설치하십시오.

  4. 다음 명령을 사용하여 설치를 확인하십시오.

    docker --version
docker run hello-world

    로그아웃한 후 Docker 디먼이 시작될 때까지 기다려야 할 수 있습니다.

kubectl

  1. https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windows에서 kubectl 를 다운로드하십시오.
  2. kubectl.exe 바이너리를 사용자의 PATH로 이동하십시오.
  3. 다음 명령을 사용하여 설치를 확인하십시오.
    kubectl version --client=true

oc

  1. https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/에서 최신 4.x OpenShift CLI(oc)를 다운로드하십시오.
  2. oc.exe 바이너리를 사용자의 PATH로 이동하십시오.
  3. 다음 명령을 사용하여 설치를 확인하십시오.
    oc version

Helm 3

  1. https://github.com/helm/helm/releases/latest 에서 helm을 다운로드하십시오.
  2. 다운로드된 아카이브의 압축을 푸십시오.
  3. helm.exe 바이너리를 사용자의 PATH로 이동하십시오.
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    helm version

Terraform

  1. https://developer.hashicorp.com/terraform/downloads에서 terraform 를 다운로드하십시오.
  2. 다운로드된 아카이브의 압축을 푸십시오.
  3. terraform.exe 바이너리를 사용자의 PATH로 이동하십시오.
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    terraform version

Terraform에서 IBM Cloud 리소스를 관리하려면 IBM Cloud Provider를 설치해야 할 수도 있습니다. Terraform 0.13부터 Terraform 플러그인 레지스트리에서 자동으로 제공자를 다운로드할 수 있습니다. 제공자 문서의 지시사항에 따라 Terraform 템플리트의 required_providers 특성을 구성하십시오.

jq

  1. https://jqlang.github.io/jq/에서 jq를 다운로드하십시오.
  2. jq-win64.exe의 이름을 jq.exe로 바꾸십시오.
  3. jq.exe 바이너리를 사용자의 PATH로 이동하십시오.
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    jq --version

Git

  1. https://github.com/git-for-windows/git/releases/latest 에서 git을 다운로드하여 설치하십시오.
  2. 다음 명령을 사용하여 설치를 확인하십시오.
    git --version

모든 운영 체제에 공통되는 구성으로 진행하십시오.

Apple macOS

다음 절에서는 관리자 권한이 있는 사용자가 macOS High Sierra 이상을 실행 중이라고 가정합니다. 특정 절을 완료하고 나면 모든 운영 체제에 공통되는 구성으로 진행하십시오.

IBM Cloud CLI

  1. https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest 에서 IBM Cloud CLI를 다운로드하여 설치하십시오.
  2. 다음 명령을 사용하여 설치를 확인하십시오.
    ibmcloud version

Docker

  1. Docker Desktop on Mac은 macOS에서 컨테이너 이미지를 실행하는 한 가지 옵션입니다. 설치를 진행하기 전에 라이센스 계약의 이용 약관을 검토하십시오. 다른 옵션으로는 Podman 등이 있습니다.
  2. 계정이 없으면 https://hub.docker.com/signup 에서 무료 계정에 가입하십시오.
  3. https://docs.docker.com/docker-for-windows/install/ 에서 Docker Desktop on Mac을 다운로드하여 설치하십시오.
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    docker --version
docker run hello-world

kubectl

  1. https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macos에서 kubectl 를 다운로드하십시오.
  2. kubectl 2진을 실행 가능하게 하십시오.
    chmod +x ./kubectl
  3. 이 바이너리를 사용자의 PATH로 이동하십시오.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    kubectl version --client=true

oc

  1. https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/에서 최신 4.x OpenShift CLI(oc)를 다운로드하십시오.
  2. openshift-client-mac.tar.gz (Intel) 또는 openshift-install-mac-arm64.tar.gz (Apple Silicon) 을 추출하십시오.
    tar zxvf openshift-client-mac*.tar.gz oc
  3. oc 바이너리를 사용자의 PATH로 이동하십시오.
    sudo mv ./oc /usr/local/bin/oc
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    oc version
    macOS Catalina 이상에서는 개발자를 확인할 수 없다는 메시지가 프롬프트될 수 있습니다. 그래도 oc를 실행하려면 sudo xattr -r -d com.apple.quarantine /usr/local/bin/oc를 실행하십시오.

Helm 3

  1. https://github.com/helm/helm/releases/latest 에서 helm을 다운로드하십시오.
  2. 다운로드된 아카이브의 압축을 푸십시오.
  3. helm 바이너리를 사용자의 PATH로 이동하십시오.
    sudo mv ./darwin-amd64/helm /usr/local/bin/helm
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    helm version
    macOS Catalina 이상에서는 개발자를 확인할 수 없다는 메시지가 프롬프트될 수 있습니다. 그래도 helm를 실행하려면 sudo xattr -r -d com.apple.quarantine /usr/local/bin/helm를 실행하십시오.

Terraform

  1. https://developer.hashicorp.com/terraform/downloads에서 terraform 를 다운로드하십시오.
  2. 다운로드된 아카이브의 압축을 푸십시오.
  3. terraform 바이너리를 사용자의 PATH로 이동하십시오.
    sudo mv ./terraform /usr/local/bin/terraform
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    terraform version

Terraform에서 IBM Cloud 리소스를 관리하려면 IBM Cloud Provider를 설치해야 할 수도 있습니다. Terraform 0.13부터 Terraform 플러그인 레지스트리에서 자동으로 제공자를 다운로드할 수 있습니다. 제공자 문서의 지시사항에 따라 Terraform 템플리트의 required_providers 특성을 구성하십시오.

jq

  1. https://jqlang.github.io/jq/에서 jq 를 다운로드하십시오.
  2. 다운로드된 파일의 이름을 jq로 바꾸십시오.
  3. jq 2진을 실행 가능하게 하십시오.
    chmod +x ./jq
  4. jq 바이너리를 사용자의 PATH로 이동하십시오.
    sudo mv ./jq /usr/local/bin/jq
  5. 다음 명령을 사용하여 설치를 확인하십시오.
    jq --version
    macOS Catalina 이상에서는 개발자를 확인할 수 없다는 메시지가 프롬프트될 수 있습니다. 그래도 jq를 실행하려면 sudo xattr -r -d com.apple.quarantine /usr/local/bin/jq를 실행하십시오.

Git

  1. git이 설치되었는지 확인하십시오.
    git --version
    macOS에서 개발자 도구를 설치하라는 메시지를 표시할 수 있습니다. 이 도구에는 git 명령행이 포함되어 있습니다.

모든 운영 체제에 공통되는 구성으로 진행하십시오.

Ubuntu Linux

다음 절에서는 루트 권한에 대한 액세스 권한이 있는 루트가 아닌 사용자가 Ubuntu Linux를 실행 중이라고 가정합니다. 특정 절을 완료하고 나면 모든 운영 체제에 공통되는 구성으로 진행하십시오. Linux 기반 클라우드 쉘을 사용하는 경우, Cloud Shell 섹션으로 이동하십시오.

IBM Cloud CLI

  1. https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest 에서 IBM Cloud CLI를 다운로드하여 설치하십시오.
  2. 다음 명령을 사용하여 설치를 확인하십시오.
    ibmcloud version

Docker

  1. 계정이 없으면 https://hub.docker.com/signup 에서 무료 계정에 가입하십시오.
  2. https://docs.docker.com/engine/install/ubuntu/의 지시사항에 따라 Ubuntu 에 Docker Engine 을 설치하십시오.
  3. 다음 명령을 사용하여 설치를 확인하십시오.
    docker --version
sudo docker run hello-world
    루트 대신 사용자 자신의 사용자로 Docker 를 실행하려면 사후 설치 단계를 수행하십시오.

kubectl

  1. https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linux에서 kubectl 를 다운로드하십시오.
  2. kubectl 2진을 실행 가능하게 하십시오.
    chmod +x ./kubectl
  3. 이 바이너리를 사용자의 PATH로 이동하십시오.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    kubectl version --client=true

oc

  1. https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/에서 최신 4.x OpenShift CLI(oc)를 다운로드하십시오.
  2. openshift-client-linux.tar.gz의 압축을 푸십시오.
    tar zxvf openshift-client-linux.tar.gz oc
  3. oc 바이너리를 사용자의 PATH로 이동하십시오.
    sudo mv ./oc /usr/local/bin/oc
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    oc version

Helm 3

  1. https://github.com/helm/helm/releases/latest 에서 helm을 다운로드하십시오.
  2. 다운로드된 아카이브의 압축을 푸십시오.
  3. helm 바이너리를 사용자의 PATH로 이동하십시오.
    sudo mv ./linux-amd64/helm /usr/local/bin/helm
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    helm version

Terraform

  1. https://developer.hashicorp.com/terraform/downloads에서 terraform 를 다운로드하십시오.
  2. 다운로드된 아카이브의 압축을 푸십시오.
  3. terraform 바이너리를 사용자의 PATH로 이동하십시오.
    sudo mv ./terraform /usr/local/bin/terraform
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    terraform version

Terraform에서 IBM Cloud 리소스를 관리하려면 IBM Cloud Provider를 설치해야 할 수도 있습니다. Terraform 0.13부터 Terraform 플러그인 레지스트리에서 자동으로 제공자를 다운로드할 수 있습니다. 제공자 문서의 지시사항에 따라 Terraform 템플리트의 required_providers 특성을 구성하십시오.

jq

  1. 다음 명령을 사용하여 jq를 설치하십시오.
    sudo apt install jq
  2. 다음 명령을 사용하여 설치를 확인하십시오.
    jq --version

Git

  1. 다음 명령을 사용하여 git를 설치하십시오.
    sudo apt install git
  2. 다음 명령을 사용하여 설치를 확인하십시오.
    git --version

모든 운영 체제에 공통되는 구성으로 진행하십시오.

모든 운영 체제에 공통

다음 절은 모든 운영 체제에 공통입니다.

IBM Cloud CLI 플러그인

플러그인은 서비스에 특정한 명령을 사용하여 IBM Cloud CLI의 기능을 확장합니다.

  1. 다음 플러그인을 설치하십시오.
    ibmcloud plugin install container-registry
ibmcloud plugin install cloud-object-storage
ibmcloud plugin install kubernetes-service
ibmcloud plugin install vpc-infrastructure
ibmcloud plugin install code-engine
    사용 가능한 모든 플러그인을 보려면 ibmcloud plugin repo-plugins 를 실행하고 플러그인을 설치하십시오. ibmcloud plugin install <PLUGIN_NAME>

GitHub 계정

  1. https://github.com/ 에서 무료 계정에 가입하십시오.
  2. GitHub에 익숙해지도록 https://github.com/new 에서 새 공용 저장소를 작성하십시오.

IBM Cloud GitLab

IBM Cloud는 GitLab Community Edition에 빌드되고 IBM Cloud에 로그인하는 데 사용된 동일한 인증 정보를 사용하여 액세스할 수 있는 호스팅된 Git 저장소를 제공합니다. Git 저장소와의 명령행 상호작용을 단순화하도록 SSH 공개 키를 구성하는 것이 좋습니다.

  1. SSH키 쌍이 없는 경우 이 지시사항을 사용 하여 새 SSH키 쌍을 생성하십시오.
  2. 댈러스(us-south.git.cloud.ibm.com), 런던(eu-gb.git.cloud.ibm.com) 또는 프랑크푸르트(eu-de.git.cloud.ibm.com)와 같이 Git 저장소를 호스팅하려는 지역의 Git 설정에 SSH 공개 키를 추가 하십시오.

구성을 확인하려면 다음을 수행하십시오.

  1. GitLab에서 새 개인용 프로젝트를 작성하고 README를 사용하여 저장소를 초기화하는 옵션을 선택하십시오.
  2. SSH 링크로 복제하여 명령행에서 프로젝트를 체크아웃하십시오.
  3. README 파일을 업데이트하십시오.
  4. 변경사항을 커미트하고 푸시하십시오.

Cloud Shell

oc

사전 설치된 버전이 아닌 다른 버전의 OpenShift CLI를 사용해야 하는 경우 다음 단계를 따르십시오.

  1. 안정적인 최신 4.x OpenShift CLI(oc) 다운로드
    curl https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz --output oc.tar.gz
  2. oc.tar.gz의 압축을 푸십시오.
    tar zxvf oc.tar.gz oc
  3. 현재 디렉토리를 PATH에 추가하십시오.
    export PATH=$PWD:$PATH
  4. 다음 명령을 사용하여 설치를 확인하십시오.
    oc version