필요 조건 설치

필요한 Kubernetes 아티팩트가 스택을 실행하기 위해 Kubernetes에서 Helm 차트로 배치되기 때문에 kubectl 및 Helm이 설치되어 있어야 합니다. 또한 kubectl에 필요한 Oracle Cloud Infrastructure CLI(명령행 인터페이스)가 필요하며 다른 작업에 유용합니다.

이 단계에서는 다음 구성 요소를 설치합니다.

OCI 명령행 인터페이스입니다.
아직 없는 경우 kubectl 버전 1.18 이상입니다.
Helm 3.x

Oracle Cloud Infrastructure 명령행 인터페이스 설치

먼저 Oracle Cloud Infrastructure CLI(명령행 인터페이스)를 설치합니다.

Linux 또는 Mac OS X에 OCI CLI를 설치하려면 다음 명령을 실행합니다.
```
bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"
```
Enter 키를 눌러 모든 옵션에 대해 기본값을 적용합니다.
셸을 다시 시작합니다.
```
exec -l $SHELL
```
테넌시 및 사용자 OCID 수집:
1. 사용자 아이콘(오른쪽 상단)을 누르고 테넌시를 눌러 Oracle Cloud 콘솔에서 테넌시 OCID를 가져옵니다. 테넌시의 OCID(Tenancy 필드)를 복사합니다.
2. 콘솔에서 사용자, 사용자 설정을 차례로 눌러 사용자 OCID를 가져옵니다. 그런 다음 사용자의 OCID를 복사합니다.
OCI CLI를 구성합니다.
```
oci setup config
```
다음을 입력하라는 메시지가 나타납니다.
- 구성 위치: Enter 키를 누릅니다.
- user_ocid: 사용자 OCID를 입력합니다.
- tenancy_ocid: 테넌시 OCID를 입력합니다.
- region: 제공된 목록에서 영역을 입력합니다.
- RSA 키 쌍 생성: Yes로 Enter 키를 누릅니다(기본값).
- 키 디렉토리: 기본값으로 Enter 키를 누릅니다.
- 키 이름: 기본값으로 Enter를 누릅니다.
- Passphrase: 문장암호를 사용하지 않으려면 Enter 키를 누릅니다.
다음과 같은 출력이 표시됩니다.
```
Private key written to: /home/oracle/.oci/oci_api_key.pem
Fingerprint: 21:d4:f1:a0:55:a5:c2:ce:...
Config written to ~/.oci/config
```
CLI를 사용하려면 생성된 공개 키를 사용자 계정에 업로드해야 합니다. 다음을 입력하여 주요 콘텐츠를 가져옵니다.
```
cat ~/.oci/oci_api_key_public.pem 
```
선택적으로 원하는 편집기로 파일을 열고 인쇄된 전체 출력을 클립보드에 복사할 수 있습니다.
OCI Web Console에서 이전 단계에서 생성된 키를 추가합니다.
1. 사용자, 사용자 설정 순으로 누릅니다.
2. API Keys를 누릅니다.
3. 공용 키 추가를 누릅니다.
4. Paste Public Key를 누릅니다.
5. 위에 복사한 키를 붙여넣습니다.
6. 추가를 누릅니다.
7. 생성된 지문이 구성의 지문 출력과 일치하는지 확인합니다.
다음을 입력하여 CLI를 테스트합니다.
```
oci os ns get
```
이 명령은 테넌시의 네임스페이스(일반적으로 테넌시 이름 또는 무작위 문자열)를 출력해야 합니다. 예를 들면 다음과 같습니다.
```
{
    "data": "your-tenancy-namespace"
}
```

kubectl 설치

그런 다음 Kubernetes 명령행 도구 kubectl를 설치합니다.

주:

Mac OS X 또는 Windows에서 Docker Desktop을 사용하는 경우 kubectl이 이미 설치되어 있어야 하며 이 단계를 건너뛸 수 있습니다.

다음은 kubectl 설치를 위한 상위 레벨 절차입니다. O/S에 대한 자세한 지침은 "시작하기 전에" 항목에 나열된 Kubernetes 온라인 설명서의 "설치 도구"를 참조하십시오.

kubectl를 설치하려면 다음 명령을 실행합니다.

PLATFORM=$(uname)
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/${PLATFORM,,}/amd64/kubectl"
chmod +x ./kubectl
sudo mv ./kubectl /usr/local/bin/kubectl

Windows의 경우 다음을 사용합니다.

curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.20.0/bin/windows/amd64/kubectl.exe

PATH에 이진을 추가합니다.
다음을 입력하여 1.18 이상의 kubectl 버전을 사용하고 있는지 확인합니다.
```
kubectl version --client
```

Helm 설치

이제 Helm CLI를 설치합니다.

다음은 Helm을 설치하기 위한 고급 절차입니다. O/S에 대한 자세한 지침은 "시작하기 전에" 항목에 나열된 "Helm 설치"를 참조하십시오.

Mac OS X 및 Linux에 helm을 설치하려면 다음을 입력합니다.

curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash

Terraform 설치

마지막으로 아직 설치되지 않은 경우 Terraform을 설치해야 합니다.

주:

이 항목에서 참조된 설치 설명서에 대한 링크는 "시작하기 전에" 항목에서 찾을 수 있습니다.

If you are on a Linux-based machine or Mac OS X, we recommend you install Terraform by using tfswitch, as described in Install in tfswitch documentation, as it allows easy switching between Terraform versions. If you installed tfswitch, select a version with:

tfswitch

이 플레이북은 Terraform 버전 0.14.11로 테스트되었습니다.

그렇지 않으면 Terraform 설정에 대한 지침이 필요한 경우 Terraform 설치 설명서를 방문하여 환경에 해당하는 경로를 선택하십시오.