Trong bài viết này, chúng ta sẽ tìm hiểu cách sử dụng công cụ sentry-cli để quản lý dữ liệu dự án thông qua giao diện API của Sentry. Công cụ này đặc biệt hữu ích trong việc xử lý các tệp tin thông tin gỡ lỗi (iOS, Android) và quản lý phiên bản (release) cũng như ánh xạ nguồn (source maps) cho nhiều nền tảng khác nhau.
Cài đặt
Sử dụng Docker Image
Lệnh mặc định sẽ chạy trong thư mục /work. Bạn cần gắn kết thư mục dự án của mình vào đây để cho phép sentry-cli quét tài nguyên:
# Tải xuống image Docker
docker pull getsentry/sentry-cli
# Chạy lệnh kiểm tra giúp đỡ
docker run --rm -v $(pwd):/work getsentry/sentry-cli --help
Kết quả hiển thị sẽ cung cấp thông tin về cách sử dụng công cụ:
# Công cụ dòng lệnh dành cho Sentry.
# Hỗ trợ bạn quản lý các tài nguyên từ xa trên máy chủ Sentry như:
# sourcemaps, tệp thông tin gỡ lỗi hoặc phiên bản (releases).
# CÚ PHÁP SỬ DỤNG:
# sentry-cli <LENH_CON>
# THAM SỐ:
# --api-key <API_KEY>
# Khóa API Sentry được chỉ định.
# --auth-token <AUTH_TOKEN>
# Sử dụng mã thông báo xác thực Sentry.
# -h, --help
# In ra thông tin trợ giúp này.
# --log-level <LOG_LEVEL>
# Đặt mức độ chi tiết của nhật ký. [các giá trị có thể: trace, debug, info, warn, error]
# --url <URL>
# URL đầy đủ đến máy chủ Sentry.
# [mặc định là https://sentry.io/]
# -V, --version
# In ra thông tin phiên bản.
# LỆNH CON:
# bash-hook In ra tập lệnh bash xử lý lỗi.
# difutil Tìm kiếm hoặc phân tích tệp thông tin gỡ lỗi.
# help In ra thông tin trợ giúp này hoặc trợ giúp cho lệnh con đã cho.
# info In thông tin về máy chủ Sentry.
# issues Quản lý các vấn đề trong Sentry.
# login Xác thực với máy chủ Sentry.
# projects Quản lý dự án trên Sentry.
# react-native Tải lên các tệp xây dựng cho dự án react-native.
# releases Quản lý phiên bản trên Sentry.
# repos Quản lý kho lưu trữ trên Sentry.
# send-event Gửi sự kiện thủ công đến Sentry.
# upload-dif Tải lên các tệp thông tin gỡ lỗi.
# upload-proguard Tải lên tệp ánh xạ ProGuard cho dự án.
Cấu hình và xác thực
File cấu hình
Công cụ sentry-cli hỗ trợ cấu hình qua file .sentryclirc, biến môi trường hoặc file .env. Nó sẽ tự động tìm kiếm file cấu hình từ đường dẫn hiện tại trở lên và luôn tải các giá trị mặc định từ ~/.sentryclirc.
Ví dụ file .sentryclirc:
[auth]
token=mau-thong-bao-xac-thuc
[defaults]
org=sentry
project=du-an-mau-react
url=https://x.xxx.com
Tạo phiên bản mới
Để tạo một phiên bản mới, bạn có thể truy cập vào container và sử dụng lệnh sau:
# Vào shell của container
docker run --rm -it -v $(pwd):/work getsentry/sentry-cli /bin/sh
# Tạo phiên bản mới
sentry-cli releases new 1.0.0