Lino 시작하기

사전 요구 사항

Lino를 설치하기 전에 환경이 제대로 준비되었는지 확인하세요:

• ✅ .NET 10.0 SDK 이상 설치. .NET 다운로드
• ✅ 터미널에서 .NET CLI 사용 가능. 다음으로 확인: dotnet --version
• ✅ 버전 관리를 위한 Git 설치. Git 다운로드
• ✅ migrations 지원을 위한 Entity Framework Core CLI 설치: dotnet tool install --global dotnet-ef
• ✅ Docker Desktop 또는 Podman과 같은 OCI 호환 컨테이너 환경.

플랫폼 호환성

Lino는 크로스 플랫폼이며 주요 운영 체제에서 사용할 수 있습니다:

• ✅ Windows
• ✅ macOS
• ✅ Linux

설치

Lino는 전역 .NET 도구로 배포됩니다. 계속하기 전에 .NET 10 SDK 이상이 설치되어 있는지 확인하세요.

최신 버전을 설치하려면 다음을 실행하세요:

dotnet tool install --global Tolitech.Lino

설치 후 다음을 실행하여 Lino가 정상 동작하는지 확인하세요:

lino --version

설치가 성공하면 설치된 버전이 터미널에 표시됩니다.

인증

Lino를 설치한 후 모든 기능에 접근하려면 인증을 수행해야 합니다.

이미 계정이 있다면 다음 명령으로 로그인하세요:

lino auth login

다음 정보를 입력하라는 요청을 받습니다:

• 사용자: 이전에 등록한 이메일 주소.
• 비밀번호: 계정에 연결된 비밀번호.

아직 계정이 없다면 CLI에서 직접 등록하세요:

lino user register

등록 중에는 다음 정보를 입력합니다:

• 이름: 사용자의 이름.
• 성: 사용자의 성.
• 이메일: 로그인으로도 사용될 이메일 주소.
• 비밀번호: 최소 6자 이상의 안전한 비밀번호.
• 비밀번호 확인: 검증을 위해 비밀번호를 다시 입력합니다.

등록이 완료되면 사용자는 자동으로 인증됩니다.

언어 기본 설정

기본적으로 Lino CLI는 영어 en으로 표시되지만, 사용 가능한 옵션 중 원하는 언어로 변경할 수 있습니다:

en | pt | es | de | fr | it | ja | ko | ru | zh

새 언어를 설정하려면 다음 명령을 실행하세요:

lino preferences culture set --name <culture>

<culture>를 지원되는 culture 중 하나로 바꾸세요. 예를 들어 포르투갈어는 pt, 영어는 en, 스페인어는 es를 사용합니다.

또는 다음 명령으로 대화형 목록에서 언어를 선택할 수 있습니다:

lino preferences culture set

UTF-8 인코딩 조정(선택 사항)

일본어, 한국어, 러시아어 또는 중국어처럼 특수 문자가 있는 언어를 올바르게 표시하려면 터미널이 UTF-8 인코딩을 사용하도록 구성되어 있는지 확인하세요.

Windows PowerShell에서는 다음 명령을 실행하여 인코딩을 조정합니다:

[console]::InputEncoding = [System.Text.Encoding]::UTF8

[console]::OutputEncoding = [System.Text.Encoding]::UTF8

참고: Linux, macOS 및 Windows Terminal에서는 UTF-8 지원이 일반적으로 기본 제공됩니다. 그래도 문자 표시 문제가 발생하면 구성을 확인하는 것이 좋습니다.

사용 가능한 명령

Lino는 자동화를 명령 그룹으로 구성합니다. 각 그룹은 solution 생성, 서비스 추가, 도메인 모델링, APIs 공개, 페이지 생성, 통합 구성, migrations 제어, 아티팩트 버전 관리, builds 준비와 같은 아키텍처 의도를 나타냅니다.

현재 머신에서 가장 신뢰할 수 있는 참조는 설치된 CLI 자체의 도움말입니다. lino --help를 사용해 전체 명령 트리를 확인하고, 어떤 그룹에서든 --help를 사용해 옵션, aliases, 필수 매개변수 및 예제를 확인하세요.

Lino는 지속적으로 발전하므로 버전 사이에 새로운 명령과 옵션이 추가될 수 있습니다. 이 문서는 사용 지침으로 보고, 워크플로를 자동화하거나 팀원을 교육할 때는 항상 터미널에서 정확한 구문을 확인하세요.

사용 가능한 명령 목록을 표시하려면 루트 명령을 실행하거나 명시적으로 도움말을 요청할 수 있습니다.

lino
lino --help

lino --help
lino project --help
lino database migrations --help
lino integration operation --help

어떤 그룹의 하위 명령과 옵션이든 확인하려면 명령 이름만 사용하거나 --help와 함께 사용하세요.

lino <command>
lino <command> --help

예를 들어 project 그룹을 조회하면 CLI는 그룹 설명, 일반적인 예제 및 사용 가능한 하위 명령을 표시합니다.

lino project --help

설명:
    Lino 프로젝트를 관리합니다.

예제:
    lino project new --name MyProject
    lino project list

명령:
    new     새 프로젝트를 만듭니다.
    list    생성된 프로젝트를 나열합니다.
    delete  기존 프로젝트를 제거합니다.

예제를 읽을 때 <...> 안의 값은 프로젝트의 실제 값으로 바꿔야 하는 인수를 의미합니다. 예를 들어 <ProjectName>은 solution 이름으로, <ServiceName>은 서비스 이름으로, <culture>는 pt 또는 en 같은 지원 culture로 바꿔야 합니다.

주요 명령 그룹:

일부 명령은 편의를 위해 괄호 안에 짧은 alias를 표시합니다. 원래 이름은 읽기, 문서화, 교육, 자동화 및 지원의 주요 참조로 유지됩니다.

빠른 시작

다음 명령으로 지속적인 발전에 대비된 현대적이고 확장 가능한 .NET 애플리케이션을 빠르게 만드세요:

lino project new --name <ProjectName>

<ProjectName>을 solution의 실제 이름으로 바꾸세요. 예를 들어 MyApp이라는 프로젝트를 만들려면 lino project new --name MyApp을 실행합니다.

이 명령은 도메인, 애플리케이션, 인프라, 영속성, API, 오케스트레이션 및 테스트를 명확히 분리한 .NET solution을 생성합니다. 초기 구조는 첫 commit부터 아키텍처 결정을 눈에 보이게 유지하고, 비즈니스 규칙, 데이터 접근, endpoints 및 운영 세부 사항이 같은 위치에 섞이지 않도록 돕습니다.

시각적으로 MyApp이라는 초기 solution은 다음과 같이 이해할 수 있습니다:

MyApp/
├── MyApp.slnx
├── src/
│   ├── Aspire/
│   │   ├── AppHost/
│   │   │   └── MyApp.AppHost.csproj
│   │   └── ServiceDefaults/
│   │       └── MyApp.ServiceDefaults.csproj
│   └── Services/
│       └── Shared/
│           ├── Api/
│           │   └── MyApp.Shared.Api.csproj
│           ├── Application/
│           │   └── MyApp.Shared.Application.csproj
│           ├── Domain/
│           │   └── MyApp.Shared.Domain.csproj
│           ├── Infrastructure/
│           │   └── MyApp.Shared.Infrastructure.csproj
│           └── Infrastructure.Persistence/
│               └── MyApp.Shared.Infrastructure.Persistence.csproj
└── tests/

이 트리는 사용자 프로젝트에 생성되는 구조를 설명하는 교육용 예시입니다. solution이 처음부터 로컬 실행, 서비스, 기술 계층 및 테스트를 어떻게 분리하는지 보여 줍니다.

초기 프로젝트가 제공하는 것

Lino가 만든 초기 solution은 처음부터 기술 책임별로 구성됩니다. CLI는 빈 프로젝트만 제공하는 대신, 엔터프라이즈 애플리케이션에 적합한 계층과 컴포넌트를 갖춘 기반을 준비합니다.

<ProjectName>에 입력한 이름은 solution의 기술적 정체성 일부가 됩니다. namespaces, assemblies, 아티팩트, 구성 및 컴포넌트 간 참조에 사용되므로 짧고 안정적이며 대표적인 이름을 선택하세요.

주요 이점:

• 명시적 아키텍처: 비즈니스 규칙, use cases, 인프라, 영속성 및 입력 계약을 분리합니다.
• 모듈형 진화: 컨텍스트가 요구할 때 전통적인 서비스, 모듈형 모놀리스, 마이크로서비스 및 SaaS 애플리케이션에 대비된 기반입니다.
• 일관된 기술 패턴: DDD, Clean Architecture, CQRS, 이벤트, 통합, migrations, 테스트 및 observability를 지원합니다.
• 기계적 작업 감소: 반복 구조를 생성하여 개발자가 도메인, 규칙, 계약 및 제품 결정에 에너지를 집중할 수 있게 합니다.
• 더 예측 가능한 코드: 명명 규칙, 폴더 구성 및 책임 구분이 팀원 간의 모호성을 줄입니다.

Lino를 사용하면 개발자는 빈 폴더나 generic template에서 시작하지 않습니다. 엔터프라이즈 시스템을 위해 설계된 opinionated 기반에서 시작하며, 생성되는 각 아티팩트는 명확한 기술적 기능을 가지고 점진적으로 발전할 수 있습니다.