> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morph-data.io/llms.txt
> Use this file to discover all available pages before exploring further.

# バージョンマイグレーションガイド

このページでは、バージョン間の変更点と、あるバージョンから別のバージョンへの移行方法について説明します。

## Morph 0.2.1 to 0.3.0

### Dockerfileのアップデート: フロントエンドのビルド

v0.3.0ではフロントエンドのビルドが追加されました。ローカル環境から `morph deploy` を実行する場合は、以下のようにDockerfileを更新してください。

```dockerfile theme={"dark"}
FROM node:lts AS morph-frontend-build

WORKDIR /var/task

# Copy source code and dependencies
COPY . .

RUN npm install
RUN npm run build

# Base image for Morph Cloud
FROM public.ecr.aws/i1l4z0u0/morph-data:python3.12

# Set working directory
WORKDIR /var/task

# Install Python dependencies
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt --target "\${MORPH_PACKAGE_ROOT}"

# Copy source code and dependencies
COPY . .

COPY --from=morph-frontend-build /var/task/.morph .morph
COPY --from=morph-frontend-build /var/task/dist dist

# Command to run the Lambda function
CMD python "\${MORPH_APP_FILE_PATH}"
```

### `morph_project.yml`のアップデート

v0.3.0では、`morph_project.yml`の設定が変更になりました。[こちらのリファレンス](/reference/ja/framework/morph-project)を参照してください。

```yaml theme={"dark"}
version: '1'

# Framework Settings
default_connection: DUCKDB
source_paths:
- src

# Cloud Settings
profile: default # Defined in the Profile Section in `~/.morph/credentials`
project_id: xxxxxx-xxxxx-xxxx-xxxxx

# Build Settings
build:
    # These settings are required when there is no Dockerfile in the project root.
    # They define the environment in which the project will be built
    runtime: python3.9 # python3.9, python3.10, python3.11, python3.12
    framework: morph # morph | streamlit
    package_manager: pip # pip, poetry, uv
    # These settings are required when there is a Dockerfile in the project root.
    # They define how the Docker image will be built
    context: .
    build_args:
        ARG1: value1
        ARG2: value2

# Deployment Settings
deployment:
    provider: aws
    aws:
        region: us-east-1
        memory: 512
        timeout: 30
    gcp:
        region: us-central1
        memory: "1Gi"
        cpu: 1
        concurrency: 80
        timeout: 300
```

### フロントエンドのアップデート

v0.3.0 ではフロントエンドのプロジェクト構成が変更されました。

マイグレーションのために以下の手順でプロジェクトをアップデートしてください。

1. `morph-data~=0.3`をインストール後、以下のコマンドを実行してください
   * プロジェクトのルートで実行してください。
   * venv や virtualenv を利用している場合は、仮想環境を有効化した状態で実行してください。
2. \[npm のパッケージを追加でインストールしていた場合のみ] インストールしていたパッケージを手動で再度インストールしてください。

```bash theme={"dark"}
python <<EOF
import morph
import os
import shutil
import subprocess

morph_data_installed_dir = os.path.dirname(morph.__file__)
starter_template_dir = os.path.join(
    morph_data_installed_dir, "include", "starter_template"
)

def migrate_frontend():
    def copy_starter_template_file(path: str):
        src = os.path.join(starter_template_dir, path)
        dst = os.path.join(os.getcwd(), path)

        os.makedirs(os.path.dirname(dst), exist_ok=True)
        shutil.copy(src, dst)

    # Copy files
    copy_starter_template_file("vite.config.ts")
    copy_starter_template_file("tsconfig.json")
    copy_starter_template_file("package.json")
    copy_starter_template_file("components.json")
    copy_starter_template_file("src/pages/_app.tsx")
    copy_starter_template_file("src/pages/404.tsx")
    copy_starter_template_file("src/pages/index.css")
    copy_starter_template_file("src/pages/_lib/utils.ts")
    copy_starter_template_file("src/pages/_components/table-of-contents.tsx")
    copy_starter_template_file("src/pages/_components/header.tsx")

    # Init components
    subprocess.run(
        [
            "npx",
            "shadcn@latest",
            "add",
            "--yes",
            "https://morph-components.vercel.app/r/morph-components.json",
        ],
    )

    subprocess.run(
        [
            "npm",
            "install",
        ],
    )

if __name__ == "__main__":
    migrate_frontend()

EOF
```

## Morph 0.1.9 to 0.2.0

### Dockerfileのアップデート: CMDコマンドの変更

Github連携に伴いMorphで構築したアプリの実行コマンドをデプロイ環境にインストールする方法が変更になりました。
具体的にはローカル環境で作成した`.morph/core/morph`ディレクトリにある`api/app.py`をデプロイ環境にコピーする方式から、パッケージとしてインストールされたファイルを実行する方式に変更になりました。
それに伴い、`morph deploy`実行時にもv0.2.0以降ではdockerfileでのエントリーポイントが変更になっています。

v0.2.0の変更で`morph new`コマンドで生成されるDockerfileのCMDコマンドが変更されましたので、これまでのバージョンをお使いの場合はCMDコマンドを変更してください。

```dockerfile theme={"dark"}
# Base image for Morph Cloud
FROM public.ecr.aws/i1l4z0u0/morph-data:python3.9

# Set working directory
WORKDIR /var/task

# Install Python dependencies
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt --target "${MORPH_PACKAGE_ROOT}"

# Copy source code and dependencies
COPY . .

# Command to run the Lambda function
CMD python "${MORPH_APP_FILE_PATH}"
```

### /staticディレクトリの追加

v0.2.0ではスタティックファイルをホストするための`/static`ディレクトリが追加されました。`/static`以下に配置されたファイルは、フロントエンドアプリケーションからアクセスできます。

```markdown theme={"dark"}
# `/static`ディレクトリに配置されたファイルを画像として表示する例

![Logo](/static/logo.png)
```

これまでのバージョンをお使いの場合は`/static`ディレクトリを作成してください。

## Morph 0.1.7 to 0.1.8

### Dockerfileのアップデート: `<LLM />` `<Chat />`のストリーミング処理の改善

LLMを用いたストリーミングレスポンスの挙動の改善に伴い、DockerfileのベースイメージとCMDの設定が変更されました。

v0.1.8以降で `morph new` コマンドで初期生成されるDockerfileは以下の形式で初期化をされます。

```dockerfile theme={"dark"}
# Base image for Morph Cloud
FROM public.ecr.aws/i1l4z0u0/morph-data:python3.9

# Set working directory
WORKDIR /var/task

# Install Python dependencies
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt --target "${MORPH_TASK_ROOT}"

# Copy source code and dependencies
COPY . .

# Command to run the Lambda function
CMD ["python", ".morph/core/morph/api/app.py"]
```

併せて、初期化時に.dockerignoreファイルを生成し、COPYコマンドでは個別のファイルのコピーではなく、.dockerignoreファイルで除外されたファイルを除外したディレクトリをコピーするように変更しました。

これによりローカルの開発環境でのディレクトリ構成が変更された場合もDockerfileの更新が不要になります。