🎯 Ngày 24: Package & Deployment trong Sitecore

📌 1. Có những cách deploy nào trong Sitecore?

Trong Sitecore, có 3 phương pháp phổ biến để đưa code hoặc item sang môi trường khác:

1) Sitecore Package (Content + Files)

• Tạo từ Sitecore Desktop → Development Tools → Installation Wizard

• Dùng để:

  • Deploy template

  • Content item

  • Rendering

  • Media Items

• Không phù hợp để deploy source code.

2) Serialization Tools

• Unicorn

• TDS (Team Development for Sitecore)

• Triển khai item dựa trên source control, đồng bộ item theo folder trong project.

• Đây là cách Sitecore developer hiện đại dùng để deploy item (không dùng package nữa).

3) Deploy code (CI/CD / thủ công)

• Code (DLL + Views + JS + CSS) deploy qua:

  • Web Deploy

  • Azure DevOps Pipeline

  • Octopus Deploy

  • Copy thủ công (local → server)

📌 2. Tạo Sitecore Package đúng chuẩn

▶ Bước 1: Mở Package Designer

Desktop → Development Tools → Package Designer

▶ Bước 2: Tạo package mới

New → đặt tên package → Save metadata.

▶ Bước 3: Chọn Items để đưa vào package

Bạn có thể thêm:

• Templates

• Renderings

• Layouts

• Content items

• Media items

⭐ Lưu ý quan trọng:
Luôn bỏ check "Include Children" với các folder lớn, tránh việc package hàng ngàn item.

▶ Bước 4: Chọn files

Dùng nếu cần:

• /App_Config include file

• /Views

• /bin DLL

• /sitecore modules

▶ Bước 5: Build Package

→ Export
→ Download file .zip

📌 3. Cài đặt Sitecore Package

Cách 1: Sitecore Desktop → Installation Wizard

Upload package
Kiểm tra items trước khi install
Click Install

Cách 2: Silent Install (.xml package manifest)

Dùng file XML để cài đặt package theo script.

📌 4. Khi nào KHÔNG nên dùng Package?

⛔ Khi deploy:

• Templates thường xuyên

• Layout/Rendering

• Forms

• Rules

• Dictionary

• Item cấu hình

→ Nên dùng Unicorn hoặc TDS để đảm bảo version control.

⛔ Khi deploy code
→ Code deploy bằng DevOps hoặc Visual Studio Publish.

Package chủ yếu dùng khi:

• Khách hàng không cho phép dùng Unicorn/TDS

• Muốn backup item

• Muốn export 1 phần content từ môi trường này sang môi trường khác

📌 5. Best Practices khi tạo Package

✔ Không chọn nguyên cây /sitecore/content

Chỉ chọn đúng item cần.

✔ Không package media quá lớn

Media nên deploy qua file system hoặc DAM.

✔ Luôn test package ở local trước

Import → kiểm tra → rollback nếu lỗi.

✔ Ghi rõ version package

vd:
ProjectA.Feature.Banner.1.0.3.zip

📌 6. Cách Deploy Code từ Visual Studio

1) Publish Profile (local)

Right-click Project → Publish
Chọn:

• Folder

• IIS

• FTP
  → Nhấn Publish

2) Deploy qua CI/CD

Tạo pipeline:

1. Restore NuGet

2. Build solution

3. Publish artifacts

4. Copy lên server / Azure Web App

📌 7. Kết hợp Package + Code Deployment

Một deploy hoàn chỉnh thường gồm:

📘 Bài tập thực hành cho Ngày 24

Bài 1 – Tạo Package

• Tạo template “News”

• Tạo rendering “News Listing”

• Tạo 1 content item mẫu
  → Xuất package .zip

Bài 2 – Cài đặt Package

• Import vào một Sitecore instance khác

• Kiểm tra item xuất hiện đúng

Bài 3 – Deploy Code

• Build một controller đơn giản

• Publish lên local IIS

• Kiểm tra site hoạt động bình thường