Subversion hiện thực khái niệm kho lưu trữ của kiểm soát phiên bản tương tự như những hệ thống kiểm soát phiên bản hiện đại khác. Không giống như bản sao làm việc, kho lưu trữ Subversion là một thực thể trừu tượng, có khả năng được vận hành gần như độc quyền bởi những thư viện và công cụ riêng của Subversion. Vì đa số những tương tác Subversion của người sử dụng có liên quan đến việc sử dụng ứng dụng khách Subversion và xảy ra trong phạm vi của bản sao làm việc, chúng ta sẽ dành phần lớn trong cuốn sách này thảo luận về bản sao làm việc Subversion và làm cách nào để thao tác trên nó. Để có thông tin chi tiết hơn về kho lưu trữ, kiểm tra Chapter 5, Repository Administration.

Warning

Trong Subversion, đối tượng phía máy khách mà mỗi người sử dụng của hệ thống đều có—thư mục chứa những tập tin phiên bản, đi kèm với siêu dữ liệu mà cho phép hệ thống theo dõi chúng và giao tiếp với máy chủ—gọi là bản sao làm việc. Mặc dù những hệ thống kiểm soát phiên bản khác sử dụng khái niệm “kho lưu trữ” cho đối tượng phía máy khách, cả hai đều không chính xác và là nguồn gốc gây nhầm lẫn phổ biến của việc sử dụng thuật ngữ theo cách này trong ngữ cảnh của Subversion. Bản sao làm việc được mô tả sau trong the section called “Bản sao làm việc Subversion”.

Ứng dụng khách Subversion chuyển giao (đó là, truyền những thay đổi được thực hiện) số lượng tập tin và thư mục bất kỳ bởi một giao dịch đơn nguyên tử. Khi đề cập đến giao dịch nguyên tử, chúng tôi đơn giản muốn thể hiện là: hoặc là tất cả các thay đổi được chấp nhận vào trong kho lưu trữ, hoặc không có bất kỳ thay đổi nào. Subversion sẽ cố gắng để giữ lại tính nguyên tử này trong những tình huống chương trình bị treo, hệ thống treo, vấn đề về mạng, và hành động của người dùng khác.

Mỗi khi kho lưu trữ tiếp nhận một chuyển giao (commit), việc này tạo nên một trạng thái mới của cây hệ thống tập tin, được gọi là phiên bản. Mỗi phiên bản được gán một số tự nhiên không trùng lặp, mỗi số sẽ lớn hơn số được gán cho phiên bản kế trước. Phiên bản ban đầu của một kho lưu trữ vừa tạo được đánh số 0 và nó chỉ là một thư mục gốc rỗng.

Figure 1.6, “Cây thay đổi theo thời gian” minh hoạ một cách đơn giản để hình dung kho lưu trữ. Tưởng tượng có một dãy của những số phiên bản, bắt đầu từ 0, kéo dài từ trái sang phải. Mỗi số phiên bản có một cây hệ thống tập tin treo dưới nó và mỗi cây là một “ảnh chụp” của cách kho lưu trữ làm việc sau mỗi chuyển giao.

Figure 1.6. Cây thay đổi theo thời gian

Ứng dụng khách Subversion dùng URL để xác định những tập tin và thư mục đã được đánh phiên bản trong kho lưu trữ Subversion. Hầu hết những URL này sử dụng cú pháp chuẩn, cho phép tên máy chủ và cổng được xác định như một phần của URL.

URL của kho lưu trữ Subversion không chỉ giới hạn với http://. Bởi vì Subversion cung cấp nhiều phương thức khác nhau để những ứng dụng khách của nó có thể giao tiếp với máy chủ, URL được dùng để xác định địa chỉ của kho khác biệt một chút tùy thuộc vào cơ chế truy cập kho mà nó sử dụng. Table 1.1, “URL truy cập kho lưu trữ” miêu tả những lược đồ URL khác nhau ánh xạ vào những phương thức truy cập kho lưu trữ có sẵn. Để biết thêm chi tiết về các tùy chọn máy chủ Subversion, xem Chapter 6, Server Configuration.

Việc xử lý URL của Subversion có một số điểm đáng chú ý. Ví dụ: URL chứa phương thức truy cập file:// (được sử dụng cho kho lưu trữ cục bộ) để phù hợp với quy ước cần phải có hoặc tên máy chủ localhost hoặc hoàn toàn không chứa tên máy chủ:

Ngoài ra, những người sử dụng giao thức file:// trên nền tảng Windows sẽ cần phải sử dụng một cú pháp “chuẩn” không chính thức để truy cập kho lưu trữ ở trên cùng một máy nhưng khác ổ đĩa với ổ đĩa của thư mục làm việc. Cả hai cú pháp đường dẫn URL bên dưới sẽ hoạt động, với X là ổ đĩa mà kho lưu trữ được chứa trong:

Lưu ý rằng URL sử dụng dấu gạch chéo xuôi mặc dù dạng đường dẫn gốc (không-URL) trên Windows sử dụng dấu gạch chéo ngược. Ngoài ra cũng lưu ý khi sử dụng dạng file:///X|/ ở giao diện dòng lệnh, bạn cần phải trích dẫn URL (bao quanh bằng dấu ngoặc kép) để ký tự thanh đứng không bị thông dịch như ký tự đường ống.

Note

Bạn không thể sử dụng URL file:// của Subversion với trình duyệt web thông thường theo cách mà bạn thường sử dụng. Khi bạn cố xem URL file:// trên một trình duyệt web thông thường, nó đọc và hiển thị nội dung của tập tin ở vị trí đó bằng cách kiểm tra trực tiếp hệ thống tập tin. Tuy nhiên, tài nguyên Subversion tồn tại trên một hệ thống tập tin ảo (xem the section called “Repository Layer”) và trình duyệt của bạn sẽ không hiểu làm cách nào để tương tác với hệ thống tập tin đó.

Ứng dụng khách Subversion sẽ mã hóa URL một cách tự động giống như cách mà trình duyệt web thực hiện. Lấy ví dụ, URL http://host/path with space/project/españa — mà chứa cả khoảng trắng và ký tự ASCII in hoa — sẽ được Subversion tự động thông dịch giống như khi bạn nhập http://host/path%20with%20space/project/espa%C3%B1a. Nếu URL chứa khoảng trắng, hãy nhớ đặt nó vào trong dấu ngoặc kép khi sử dụng ở giao diện dòng lệnh để Shell của bạn xử lý toàn bộ như là một tham số duy nhất cho chương trình.

Có một ngoại lệ đáng chú ý trong cách Subversion quản lý URL mà cũng được áp dụng trong cách nó quản lý đường dẫn cục bộ trong nhiều ngữ cảnh. Nếu thành phần cuối cùng của URL hoặc đường dẫn cục bộ chứa dấu a-còng (@), bạn cần phải sử dụng một cú pháp đặc biệt—được mô tả trong the section called “Peg and Operative Revisions”— để có thể làm cho Subversion định địa chỉ tài nguyên đó một cách bình thường.

Trong Subversion 1.6, một ký hiệu mũ (^) được giới thiệu như là một ký hiệu viết tắt cho “URL của thư mục gốc của kho lưu trữ”. Ví dụ, bạn có thể sử dụng ^/tags/bigsandwich/ để tham khảo đến URL của thư mục /tags/bigsandwich ở gốc của kho lưu trữ. Loại URL này được gọi là URL tương đối của kho lưu trữ. Lưu ý rằng cú pháp URL này chỉ hoạt động khi thư mục làm việc hiện hành của bạn là bản sao làm việc—ứng dụng khách Subversion giao-diện-dòng-lệnh nhận biết URL gốc của kho lưu trữ bằng cách tham khảo siêu dữ liệu của bản sao làm việc. Ngoài ra cũng lưu ý rằng khi bạn mong muốn tham khảo đến thư mục gốc của kho lưu trữ, bạn cần phải dùng ^/ (với dấu gạch chéo ở đuôi), không chỉ đơn thuần ^. Người sử dụng Windows cần phải lưu ý rằng dấu mũ là một ký tự thoát (escape character). Vì thể, dùng dấu mũ đôi ^^ nếu bạn sử dụng ứng dụng khách Subversion trên máy chạy Windows.

Một bản sao làm việc Subversion là một cây thư mục bình thường trong hệ thống cục bộ của bạn, nó chứa một bộ sưu tập tập những tập tin. Bạn có thể hiệu chỉnh những tập tin này tùy ý và nếu chúng là những tập tin mã nguồn, bạn có thể biên dịch chương trình của bạn từ những tập tin này theo cách thông thường. Bản sao làm việc của bạn là khu vực làm việc của riêng bạn: Subversion sẽ không bao giờ kết hợp thay đổi của những người khác và cũng không làm cho những thay đổi của riêng bạn có sẵn đối với những người khác, cho tới khi bạn yêu cầu nó làm việc đó một cách rõ ràng. Bạn thậm chí có thể có nhiều hơn một bản sao làm việc của cùng một dự án.

Sau khi bạn thực hiện một số thay đổi trên những tập tin trong bản sao làm việc của bạn và đã xác nhận rằng chúng hoạt động bình thường, Subversion cung cấp lệnh để bạn “phát hành” những thay đổi của bạn (bằng cách ghi vào kho lưu trữ), bằng cách đó làm cho chúng có sẵn với những người khác đang làm việc với bạn trong dự án. Nếu những người khác phát hành những thay đổi của riêng họ, Subversion cung cấp lệnh để hợp nhất những thay đổi đó vào trong bản sao làm việc của riêng bạn (bằng cách đọc từ kho lưu trữ). Lưu ý rằng trong Subversion, kho lưu trữ trung tâm là trung gian cho tất cả những thay đổi của tất cả mọi người—những thay đổi không được chuyển trực tiếp từ bản sao làm việc này tới bản sao làm việc khác trong các quy trình làm việc điển hình.

Bản sao làm việc cũng lưu trữ một vài tập tin phụ, được tạo ra và duy trì bởi Subversion, để hỗ trợ thực hiện các lệnh. Đặc biệt, mỗi bản sao làm việc chứa một thư mục con với tên .svn, được biết như là thư mục quản trị của bản sao làm việc. Những tập tin trong thư mục quản trị này hỗ trợ Subversion nhận diện được những tập tin được đánh phiên bản nào chứa những thay đổi chưa được phát hành, và những tập tin nào là quá hạn so với công việc của những người khác.

Note

Trước phiên bản 1.7, Subversion duy trì thư mục quản trị con .svn trong mỗi thư mục được đánh phiên bản trong bản sao làm việc của bạn. Subversion 1.7 cung cấp một cách tiếp cận hoàn toàn mới về cách siêu dữ liệu được lưu trữ và duy trì, và trọng yếu trong những thay đổi hiện hữu trong cách tiếp cận này là mỗi bản sao làm việc chỉ có duy nhất một thư mực con .svn là thư mục con trực tiếp của gốc của bản sao làm việc đó.

Tương tác cơ bản trên bảo sao làm việc

Một kho lưu trữ Subversion điển hình thường chứa những tập tin (hoặc mã nguồn) của nhiều dự án; thông thường, mỗi dự án là một thư mục con trong cây hệ thống tập tin. Theo cách sắp xếp này, bản sao làm việc của người dùng sẽ thông thường tương ứng với một cây con cụ thể của kho lưu trữ.

Ví dụ, giả sử bạn có một kho lưu trữ mà chứa hai dự án phần mềm, paint và calc. Mỗi dự án được bố trí trong cấp cao nhất của thư mục con riêng của dự án như được trình bày trong hình Figure 1.7, “Hệ thống tập tin của kho lưu trữ”.

Figure 1.7. Hệ thống tập tin của kho lưu trữ

Để tạo một bản sao làm việc, bạn cần phải kiểm xuất một số cây con của kho lưu trữ. (Khái niệm kiểm xuất nghe có vẻ như nó có liên quan tới khóa hoặc đặt trước nguồn lực, tuy nhiên nó không phải như vậy; nó đơn giản chỉ tạo cho bạn một bản sao làm việc của dự án.) Ví dụ, nếu bạn kiểm xuất /calc, bạn sẽ có một bản sao làm việc như thế này:

$ svn checkout http://svn.example.com/repos/calc
A    calc/Makefile
A    calc/integer.c
A    calc/button.c
Checked out revision 56.
$ ls -A calc
Makefile  button.c integer.c .svn/
$

Danh sách những ký tự A ở bên lề trái chỉ ra rằng Subversion đang thêm một số mục vào trong bản sao làm việc của bạn. Lúc này bạn có một bản sao riêng của thư mục /calc thuộc kho lưu trữ, với một mục bổ sung —.svn—mà chứa những thông tin bổ sung cần thiết cho Subversion như được đề cập trước đây.

Giả sử bạn thay đổi trên tập tin button.c. Bởi vì thư mục .svn ghi nhớ nội dung và ngày tháng chỉnh sửa gốc của tập tin, Subversion có thể cho bạn biết rằng bạn vừa mới thay đổi tập tin. Tuy nhiên, Subversion không làm cho thay đổi của bạn công khai cho tới khi bạn yêu cầu nó làm việc đó một cách rõ ràng. Động tác phát hành thay đổi của bạn thường được biết đến nhiều hơn như là chuyển giao (hoặc kiểm nhập) những thay đổi vào kho lưu trữ.

Để phát hành thay đổi của bạn, bạn có thể dùng lệnh svn commit của Subversion:

$ svn commit button.c -m "Fixed a typo in button.c."
Sending        button.c
Transmitting file data .
Committed revision 57.
$

Lúc này những thay đổi của bạn trên tập tin button.c đã được chuyển giao vào kho lưu trữ, với một ghi chú mô tả thay đổi của bạn (chẳng hạn, bạn sửa một lỗi đánh máy). Nếu một người khác kiểm xuất một bản sao làm việc của /calc, cô ấy sẽ thấy nhưng thay đổi của bạn trong phiên bản mới nhất của tập tin.

Giả sử bạn có một người cộng tác, Sally, người mà kiểm xuất một bản sao làm việc của button.c ngay cùng thời điểm mà bạn cũng kiểm xuất. Khi bạn chuyển giao những thay đổi của bạn lên button.c, bản sao làm việc của Sally không thay đổi; Subversion chỉ sửa đổi bản sao làm việc ở thời điểm người dùng yêu cầu.

Để làm cho dự án của cô ấy hiện hành, Sally có thể yêu cầu Subversion cập nhật bản sao làm việc của cô ấy với lệnh svn update. Lệnh này sẽ kết hợp những thay đổi của bạn vào bản sao làm việc của cô ấy, cũng như thay đổi của những người khác mà được chuyển giao trước khi cô ấy kiểm xuất.

$ pwd
/home/sally/calc
$ ls -A
Makefile button.c integer.c .svn/
$ svn update
Updating '.':
U    button.c
Updated to revision 57.
$

Đầu ra của lệnh svn update chỉ ra rằng Subversion đã cập nhật nội dung của tập tin button.c. Lưu ý rằng Sally không cần thiết phải chỉ định rõ sẽ cập nhật tập tin nào; Subversion sử dụng thông tin trong thư mục .svn cũng như những thông tin khác trong kho lưu trữ để quyết định tập tin nào sẽ được cập nhật.