macOS X에서 개발 환경 설정

아티클
02/23/2024

macOS X를 사용하여 Azure Service Fabric 애플리케이션을 Linux 클러스터에서 실행하도록 빌드할 수 있습니다. 이 문서에서는 개발을 위해 Mac을 설정하는 방법을 설명합니다.

필수 조건

Azure Service Fabric은 macOS X에서 기본적으로 실행되지 않습니다. 로컬 Service Fabric 클러스터를 실행하기 위해 미리 구성된 Docker 컨테이너 이미지가 제공됩니다. 시작하기 전에 다음 항목이 필요합니다.

Mac에 Docker 데스크톱을 설치하기 위한 시스템 요구 사항
Mac에서 Docker Desktop 설치 및 실행

팁

Docker를 Mac에 설치하려면 Docker 설명서의 단계를 따릅니다. 설치 후 Docker Desktop을 사용하여 리소스 제한 및 디스크 사용률을 포함한 환경 설정을 지정할 수 있습니다.

로컬 컨테이너 만들기 및 Service Fabric 설정

로컬 Docker 컨테이너를 설정하고 Service Fabric 클러스터가 실행되도록 하려면 다음 단계를 수행합니다.

다음 설정을 사용하여 호스트에서 Docker 디먼 구성을 업데이트하고 Docker 디먼을 다시 시작합니다.
```
{
    "ipv6": true,
    "fixed-cidr-v6": "fd00::/64"
}
```
이러한 설정은 Docker 설치 경로의 daemon.json 파일에서 직접 업데이트할 수 있습니다. Docker에서 디먼 구성 설정을 직접 수정할 수 있습니다. Docker 아이콘을 선택한 다음 기본 설정>디먼>고급을 선택합니다.

참고 항목

daemon.json 파일의 위치가 컴퓨터마다 다를 수 있기 때문에 Docker에서 직접 디먼을 수정하는 것이 좋습니다. 예: ~/Library/Containers/com.docker.docker/Data/database/com.docker.driver.amd64-linux/etc/docker/daemon.json.

팁

대규모 애플리케이션을 테스트할 때에는 Docker에 할당된 리소스를 늘리는 것이 좋습니다. 이렇게 하려면 Docker 아이콘을 선택한 다음, 고급을 선택하여 코어 및 메모리 수를 조정합니다.

클러스터를 시작합니다.

최신:

docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:latest

Ubuntu 18.04 LTS:

docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18

팁

기본적으로 이렇게 하면 최신 버전의 Service Fabric으로 이미지를 가져옵니다. 특정 변경 내용은 Docker Hub의 Service Fabric Onebox 페이지를 참조하세요.

선택 사항: 확장된 Service Fabric 이미지를 빌드합니다.

새 디렉터리에서 사용자 지정 이미지를 빌드하기 위한 Dockerfile이라는 파일을 만듭니다.

참고 항목

Dockerfile로 위 이미지를 조정하여 컨테이너에 추가 프로그램 또는 종속성을 추가할 수 있습니다. 예를 들어 RUN apt-get install nodejs -y를 추가하면 게스트 실행 파일인 nodejs 애플리케이션에 대한 지원이 허용됩니다.
```
FROM mcr.microsoft.com/service-fabric/onebox:u18
RUN apt-get install nodejs -y
EXPOSE 19080 19000 80 443
WORKDIR /home/ClusterDeployer
CMD ["./ClusterDeployer.sh"]
```
팁

기본적으로 이렇게 하면 최신 버전의 Service Fabric으로 이미지를 가져옵니다. 특정 수정 버전은 Docker 허브 페이지를 참조하세요.

Dockerfile에서 재사용 가능한 이미지를 빌드하려면 터미널을 열고 Dockerfile이 보관된 디렉터리로 cd한 다음, 다음을 실행합니다.
```
docker build -t mysfcluster .
```
참고 항목

이 작업에 다소 시간이 걸릴 수 있지만 한 번만 수행하면 됩니다.

이제 필요할 때마다 다음을 실행하여 신속하게 Service Fabric의 로컬 복사를 시작할 수 있습니다.
```
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mysfcluster
```
팁

읽기 쉬운 방식으로 처리할 수 있도록 컨테이너 인스턴스의 이름을 제공합니다.

애플리케이션을 특정 포트에서 수신 대기하는 경우 추가 -p 태그를 사용하여 포트를 지정해야 합니다. 예를 들어 애플리케이션이 포트 8080에서 수신 대기하는 경우 다음 -p 태그를 추가합니다.

docker run -itd -p 19000:19000 -p 19080:19080 -p 8080:8080 --name sfonebox mcr.microsoft.com/service-fabric/onebox:u18
클러스터를 시작하는 데 시간이 걸립니다. 클러스터가 실행되면 다음 명령을 사용하여 로그를 보거나, 대시보드로 이동하여 클러스터 상태(http://localhost:19080)를 볼 수 있습니다.
```
docker logs sftestcluster
```
컨테이너를 중지하고 정리하려면 다음 명령을 사용합니다. 그러나 여기서는 다음 단계에서 이 컨테이너를 사용합니다.
```
docker rm -f sftestcluster
```

알려진 제한 사항

다음은 Mac용 컨테이너에서 실행하는 로컬 클러스터의 알려진 제한 사항입니다.

DNS 서비스는 실행되지 않으며 현재 컨테이너 내에서 지원되지 않습니다. 문제 #132
컨테이너 기반 앱을 실행하려면 Linux 호스트에서 SF를 실행해야 합니다. 중첩된 컨테이너 애플리케이션은 현재 지원되지 않습니다.

Mac에서 Service Fabric CLI(sfctl) 설정

Service Fabric CLI의 지침에 따라 Mac에 Service Fabric CLI(sfctl)를 설치합니다. CLI 명령은 클러스터, 애플리케이션 및 서비스를 비롯한 Service Fabric 엔터티와의 상호 작용을 지원합니다.

애플리케이션을 배포하기 전에 클러스터에 연결하려면 아래 명령을 실행합니다.

sfctl cluster select --endpoint http://localhost:19080

Yeoman을 사용하여 Mac에서 애플리케이션 만들기

Service Fabric은 Yeoman 템플릿 생성기를 사용하여 터미널에서 Service Fabric 애플리케이션을 만들 수 있는 스캐폴딩 도구를 제공합니다. 컴퓨터에서 Service Fabric Yeoman 템플릿 생성기가 작동하는지 확인하려면 다음 단계를 수행합니다.

Node.js 및 노드 패키지 관리자가 Mac에 설치되어 있어야 합니다. 다음과 같이 HomeBrew를 사용하여 소프트웨어를 설치할 수 있습니다.
```
brew install node
node -v
npm -v
```
Node 패키지 관리자에서 머신에 Yeoman 템플릿 생성기를 설치합니다.
```
npm install -g yo
```

시작 설명서의 단계를 수행하여 원하는 Yeoman 생성기를 설치합니다. Yeoman을 사용하여 Service Fabric 애플리케이션을 만들려면 다음 단계를 수행합니다.

npm install -g generator-azuresfjava       # for Service Fabric Java Applications
npm install -g generator-azuresfguest      # for Service Fabric Guest executables
npm install -g generator-azuresfcontainer  # for Service Fabric Container Applications

생성기를 설치한 후에는 각각 yo azuresfguest 또는 yo azuresfcontainer를 실행하여 게스트 실행 파일 또는 컨테이너 서비스를 만듭니다.
Mac에서 Service Fabric Java 애플리케이션을 빌드하려면 JDK 버전 1.8 및 Gradle을 호스트 컴퓨터에 설치해야 합니다. 다음과 같이 HomeBrew를 사용하여 소프트웨어를 설치할 수 있습니다.
```
brew update
brew cask install java
brew install gradle
```
Important

최신 버전의 brew cask install java는 보다 최신 버전의 JDK를 설치할 수 있습니다. JDK 8을 설치해야 합니다.

터미널에서 Mac에 애플리케이션 배포

Service Fabric 애플리케이션을 만들고 빌드한 후 Service Fabric CLI를 사용하여 애플리케이션을 배포할 수 있습니다.

Mac의 컨테이너 인스턴스 내에서 실행 중인 Service Fabric 클러스터에 연결합니다.
```
sfctl cluster select --endpoint http://localhost:19080
```
프로젝트 디렉터리 내부에서 설치 스크립트를 실행합니다.
```
cd MyProject
bash install.sh
```

.NET Core 3.1 개발 설정

Mac용 .NET Core 3.1 SDK를 설치하여 C# Service Fabric 애플리케이션 만들기를 시작합니다. .NET Core Service Fabric 애플리케이션의 패키지는 NuGet.org에서 호스트됩니다.

Mac에 Eclipse용 Service Fabric 플러그 인 설치

Azure Service Fabric은 Java IDE용 Eclipse Neon(이상)의 플러그 인을 제공합니다. 플러그 인은 Java 서비스를 만들고 빌드하고 배포하는 프로세스를 간소화합니다. Eclipse용 Service Fabric 플러그 인을 설치하거나 최신 버전으로 업데이트하려면 다음 단계를 수행합니다. Eclipse용 Service Fabric 설명서의 다른 단계도 적용할 수 있습니다. 애플리케이션 빌드, 애플리케이션에 서비스 추가, 애플리케이션 제거 등을 수행할 수 있습니다.

마지막 단계는 호스트와 공유되는 경로로 컨테이너를 인스턴스화하는 것입니다. Mac의 Docker 컨테이너로 작업하려면 플러그인에 이러한 유형의 인스턴스화가 필요합니다. 예시:

docker run -itd -p 19080:19080 -v /Users/sayantan/work/workspaces/mySFWorkspace:/tmp/mySFWorkspace --name sfonebox mcr.microsoft.com/service-fabric/onebox:latest

특성은 다음과 같이 정의됩니다.

/Users/sayantan/work/workspaces/mySFWorkspace는 Mac에 있는 작업 영역의 정규화된 경로입니다.
/tmp/mySFWorkspace는 작업 영역을 매핑해야 하는 컨테이너 내부의 경로입니다.

참고 항목

작업 영역의 이름/경로가 다른 경우 docker run 명령에서 이 값을 업데이트합니다.

sfonebox가 아닌 이름으로 컨테이너를 시작하는 경우 Service Fabric 작업자 Java 애플리케이션의 testclient.sh 파일에서 이름 값을 업데이트합니다.