Apache Subversion Basics with TortoiseSVN
#Subversion #TortoiseSVN #CodeRepository
Full steps can be found at https://i12bretro.github.io/tutorials/0059.html
Install TortoiseSVN
01. Download TortoiseSVN https://tortoisesvn.net/downloads.html
02. Install TortoiseSVN
Creating a New Repository
01. Navigate to where you are storing your Subversion repository databases
02. Create a new folder matching the application name
03. Inside the new folder, right click in the whitespace ≫ TortoiseSVN ≫ Create respository here
04. When the dialog appears, click the Create folder structure option, this will create the standard "trunk", "branches" and "tags" directories inside the new repository
Creating a Working Directory
01. Create a folder to contain the working copy of the code, this could be on a development web server
02. Inside the new application folder, right click in the whitespace ≫ SVN Checkout...
03. Input the URL to the repository to work with, this can be either a file:// or http(s):// URL if Apache HTTPD has been setup for Subversion (Video link: )
Examples:
file:///E:/SVN_Repos/new_code/trunk
https://svn.i12bretro.local/new_code/trunk
Committing Changes to the Repository
01. After completing code changes, right click in the white space of the working directory ≫ SVN Commit...
02. Input meaningful comments about the changes completed
03. Click OK
Importing Existing Code Into Subversion
01. Create the Subversion repository using the steps above
02. Navigate to the folder that contains your code
03. Right click in the whitespace ≫ TortoiseSVN ≫ Import...
04. Input the URL to the repository to work with, this can be either a file:// or http(s):// URL if Apache HTTPD has been setup for Subversion (Video link: )
Examples:
file:///E:/SVN_Repos/import_code/trunk
http://svn.i12bretro.local/import_code/trunk
05. Input a meaningful comment about the state of the code being imported
06. To convert the current directory into a working directory after successfully importing the code into the repository, simply right click in the whitespace ≫ SVN Checkout...
07. Input the URL to the repository to work with
08. Verify the checkout path, making sure no unwanted sub-directories were added based on the repository URL (for example, I've found that TortoiseSVN will add /trunk to the checkout directory)
09. Click OK
10. A dialog will display stating that the directory selected is not empty ≫ Confirm the target folder path and Click Checkout
Deploying Updates with Subversion Workflow
01. After completing development and testing the code, you'll be ready to deploy it to a production environment
02. Navigate to the folder on the production environment ≫ Right click in the whitespace ≫ SVN Checkout...
03. Input the URL to the repository to work with, this can be either a file:// or http(s):// URL if Apache HTTPD has been setup for Subversion
Examples:
file:///E:/SVN_Repos/import_code/trunk
https://svn.i12bretro.local/import_code/trunk
04. After the checkout completes the production directory will contain an exact copy of code in /trunk of the repository
Relocating Subversion Repository
This is useful if the location (file path or URL) of the repository has changed but the repository remains the same. For example, migrating to a new server or from file paths to Apache HTTPD based URLs
01. Navigate to the working directory in Windows Explorer
02. Right click in the white space ≫ TortoiseSVN ≫ Relocate...
03. Input the URL to the new location of the matching repository
Examples:
file:///E:/SVN_Repos/import_code/trunk
https://svn.i12bretro.local/import_code/trunk
04. A dialog stating the relocate succeeded should be displayed
05. Right click in the white space ≫ TortoiseSVN ≫ Repo-browser
06. The new updated URL should be displayed
Tagging Releases
Once development and testing are completed for a version of the code, you can create a tag in Subversion. This is a snapshot of the code set and can we used to roll back to the exact version in the future if needed
01. Right click in the whitespace anywhere in Windows
02. Select TortoiseSVN ≫ Repo-browser
03. Input the URL to the repository to work with
04. Right click on the trunk folder in the left navigation pane ≫ Copy to...
05. Input the URL to the new tag to create, for example http://svn.i12bretro.local/code_repo/tags/1.0
06. Click OK
07. Input a comment such as "Creating v1.0 tag" ≫ Click OK
08. In the Repo browser, expand the tags directory to see the newly created tag
....Full steps can be found on GitHub [link at the top]
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro