MongoDB Realm CI CD

Phát triển

Giai đoạn Phát triển là bước đầu tiên để tạo các tính năng mới và sửa lỗi trong Ứng dụng. Trong giai đoạn này, bạn làm việc với các tệp cấu hình và mã nguồn của ứng dụng để thực hiện các thay đổi mong muốn của mình

Để phát triển các tính năng mới cho một ứng dụng hiện có

1. Rẽ nhánh ứng dụng chính và. Phiên bản này sẽ có ID ứng dụng khác với ứng dụng sản xuất của bạn. Bạn cũng có thể sử dụng để sử dụng các nguồn dữ liệu phát triển và các dịch vụ khác không được liên kết với sản xuất

2. Phát triển ứng dụng của bạn. Điều này có thể liên quan đến việc cập nhật hoặc thêm màn hình ứng dụng khách, thêm trình kích hoạt cơ sở dữ liệu mới hoặc bất kỳ tính năng ứng dụng nào khác. Bạn có thể sử dụng nếu bạn cần thực hiện các thay đổi đối với Lược đồ đối tượng Realm đã đồng bộ hóa của mình

1. Chạy thử nghiệm tự động cục bộ để đảm bảo rằng mã của bạn không đưa ra bất kỳ lỗi mới nào. Các thử nghiệm vượt qua cục bộ không đảm bảo rằng ứng dụng của bạn không có lỗi tích hợp, nhưng tăng độ tin cậy rằng các thay đổi của bạn không bao gồm bất kỳ hồi quy hoặc hành vi ngoài ý muốn nào

dàn dựng

Giai đoạn Dàn dựng, mà bạn cũng có thể gọi là QA (Đảm bảo chất lượng), Thử nghiệm hoặc Tiền sản xuất, là một bước mô phỏng các thay đổi phát triển của bạn trong một môi trường càng giống với sản xuất càng tốt. Điều này cung cấp cho bạn phiên bản có thể sử dụng của ứng dụng để xem xét và có thể giúp bạn phát hiện các lỗi tích hợp với các dịch vụ đang hoạt động mà không ảnh hưởng đến dữ liệu sản xuất

Các chi tiết cụ thể của triển khai theo giai đoạn của bạn tùy thuộc vào nhu cầu của ứng dụng của bạn. Tuy nhiên, bạn có thể sử dụng quy trình cấp cao sau để thiết lập

1. Thiết lập môi trường dàn dựng của bạn. Sử dụng các nguồn dữ liệu và dịch vụ riêng biệt, phi sản xuất với các cấu hình phản ánh sản xuất càng sát càng tốt. Ví dụ: bạn có thể sử dụng cụm Atlas có tên

   staging có cùng cấu hình với cụm production của bạn. Tùy thuộc vào trường hợp sử dụng của bạn, bạn có thể có một Ứng dụng nhất quán mà bạn sử dụng lại cho tất cả các bản dựng theo giai đoạn hoặc bạn có thể tạo một Ứng dụng mới cho mỗi bản dựng theo giai đoạn

2. Tạo hoặc sử dụng bản dựng dàn hiện có. Bạn có thể tự động tạo bản dựng theo giai đoạn như một phần của quy trình CI/CD, chẳng hạn như khi bạn tạo một yêu cầu kéo mới mới. Bạn có thể cho từng bản dựng theo giai đoạn hoặc bạn có thể chia sẻ trên các bản dựng

3. Xác minh rằng ứng dụng của bạn hoạt động như mong đợi. Điều này có thể liên quan đến việc chạy bộ thử nghiệm tự động đối với môi trường dàn dựng của bạn, kiểm tra hành vi theo cách thủ công hoặc nhận được sự chấp thuận thông qua thử nghiệm chấp nhận của người dùng

Sản lượng

Giai đoạn Sản xuất là bước triển khai cuối cùng nơi ứng dụng đã sửa đổi của bạn được triển khai vào môi trường sản xuất của bạn. Lý tưởng nhất là ở giai đoạn này, bạn đã kiểm tra các thay đổi của mình cục bộ và theo giai đoạn để xác nhận rằng chúng an toàn để triển khai. Bạn có thể triển khai để sản xuất theo cách thủ công hoặc tự động như một phần của quy trình làm việc CI/CD của mình bằng cách

Định cấu hình môi trường

Cấu hình và mã cho ứng dụng của bạn nhìn chung phải giống nhau giữa các giai đoạn phát triển. Tuy nhiên, bạn sẽ muốn thay đổi giá trị của một số tùy chọn cấu hình tùy thuộc vào môi trường

Xác định giai đoạn bạn đang xây dựng và đặt các giá trị cấu hình phù hợp. Ví dụ: bạn có thể định cấu hình ứng dụng bằng ID ứng dụng của một ứng dụng mới trong giai đoạn Phát triển hoặc sử dụng ID ứng dụng sản xuất của bạn trong giai đoạn Sản xuất

# Use the production App ID for the main branchexport REALM_APP_ID="myapp-abcde"# Use a staging App ID for the QA branchexport REALM_APP_ID="myapp-staging-fghij"# Use a new App ID for development branches - you'll need to create the app first!export REALM_APP_ID="myapp-dev-zyxwv"

Mẹo

Tìm ID ứng dụng của bạn

Không phải lúc nào bạn cũng có thể mã hóa cứng ID ứng dụng của mình. Bạn có thể tra cứu ID ứng dụng cụ thể với Realm CLI. Ví dụ, xem

Thiết lập Realm CLI

là cách dễ nhất để lập trình tạo, định cấu hình và quản lý Ứng dụng dịch vụ ứng dụng. Bạn nên và sử dụng phiên bản mới nhất trong tập lệnh triển khai của mình

npm install -g mongodb-realm-cli

Bạn cũng sẽ cần một cặp khóa API công khai/riêng tư của MongoDB Atlas để xác thực và sử dụng CLI. Để biết thêm thông tin và hướng dẫn cách lấy khóa API, hãy xem

Để đăng nhập, hãy lưu các khóa API của bạn trong cấu hình hồ sơ được đặt tên mới rồi đăng nhập bằng hồ sơ đó

~/.config/realm-cli/.yaml

 Name>:  public_api_key: ""  private_api_key: ""  atlas_base_url: "https://cloud.mongodb.com"  realm_base_url: "https://realm.mongodb.com"  telemetry_mode: ""

realm-cli login --profile=""

Mẹo

Đảm bảo sử dụng cờ --profile trong tất cả các lệnh của bạn, nếu không Realm CLI sẽ không nhận ra rằng bạn đã đăng nhập

Tạo một ứng dụng

Bạn có thể sử dụng Realm CLI để tạo các ứng dụng mới để sử dụng trong quá trình phát triển và thử nghiệm. Nếu quy trình của bạn đang trong giai đoạn Phát triển hoặc Giai đoạn chạy thử, thì bạn nên triển khai và thử nghiệm các thay đổi với một ứng dụng không phải là ứng dụng sản xuất trực tiếp của mình

Để sử dụng một ứng dụng mới cho nhánh phát triển hoặc dàn dựng của bạn

1. Tạo một ứng dụng mới

   Đẩy một ứng dụng mới dựa trên nhánh ứng dụng của bạn

   cd path/to/realmApprealm-cli push -y --project="" # e.g. --project="609ea544934fe445460219a2"

2. Lưu ID ứng dụng

   Ứng dụng mới có một giá trị ID ứng dụng duy nhất mà bạn sẽ cần xác định giá trị đó sau này trong quy trình bán hàng và trong ứng dụng khách của mình. Bạn nên lưu giá trị vào biến môi trường, tệp hoặc vị trí khác

   # Save to an environment variableoutput=$(realm-cli app describe)app_id=$(echo $output | sed 's/^.*client_app_id": "\([^"]*\).*/\1/')export REALM_APP_ID=app_id# Save to a fileecho $REALM_APP_ID > ./clients/ios/realm-app-id.txt

Cập nhật ứng dụng

Bạn có thể sử dụng Realm CLI để cập nhật ứng dụng hiện có, chẳng hạn như ứng dụng dàn dựng được chia sẻ hoặc triển khai sản xuất của bạn. Ứng dụng đã tồn tại, vì vậy bạn có thể tra cứu ID ứng dụng của nó

Để cập nhật một ứng dụng hiện có, hãy chỉ định ID ứng dụng của ứng dụng đó trong cờ

npm install -g mongodb-realm-cli

realm-cli push --remote=$REALM_APP_ID -y

Chạy thử nghiệm đối với ứng dụng

Ứng dụng của bạn phải bao gồm các bộ kiểm tra tích hợp và đơn vị tự động mà bạn có thể chạy để xác minh rằng mọi thứ đều hoạt động. Các chi tiết cụ thể về thiết lập thử nghiệm của bạn sẽ khác nhau tùy thuộc vào ứng dụng của bạn, nhưng bạn có thể cần chạy thử nghiệm trên nhiều nền tảng bằng nhiều trình mô phỏng khác nhau

Nếu bạn có các thử nghiệm tích hợp, bạn có thể kiểm tra các bản phát hành trước đó và chạy thử nghiệm tích hợp của mình đối với phiên bản Ứng dụng hiện tại để đảm bảo tính tương thích ngược

Dọn dẹp công việc

Khi kết thúc giai đoạn hoặc quy trình CI/CD, bạn có thể muốn dọn sạch các tài nguyên mà bạn đã tạo riêng cho thử nghiệm đó. Ví dụ: nếu bạn tạo một ứng dụng Phát triển hoặc Dàn dựng mới, bạn có thể xóa các ứng dụng và mọi cơ sở dữ liệu được liên kết với chúng sau khi các thay đổi của bạn được hợp nhất. Ngoài ra, bạn sẽ không muốn dọn sạch ứng dụng sản xuất của mình hoặc ứng dụng dàn liên tục nếu bạn sử dụng một ứng dụng

Trước khi bạn dọn dẹp, hãy xem xét những tài nguyên nào có thể hữu ích trong tương lai. Ví dụ: bạn có thể chọn bỏ qua việc xóa ứng dụng và cơ sở dữ liệu của chúng nếu thử nghiệm của bạn không thành công. Bằng cách đó, bạn có thể điều tra sự cố theo cách thủ công và tìm bất kỳ cài đặt ứng dụng hoặc dữ liệu nào gây ra lỗi

Vương quốc MongoDB được sử dụng để làm gì?

MongoDB và Realm có giống nhau không?

MongoDB có miễn phí không?

GitHub có thể được sử dụng cho CD CI không?