Stores & Access¶
The following describes the purpose of the various Genesis development stores and how to access them.
TL;DR¶
genesis.mivareadythemes.com
- Is setup as the production store which matches the
main
branch and is useful for sharing with clients ssoule
typically updates this monthly/quarterly asrelease
branches are merged intomain
- Is setup as the production store which matches the
genesis.mivamerchantdev.com
- Is designed to match the
develop
branch and is the main place to do integration testing after features are merged intodevelop
ssoule
typically will update this weekly after PRs/branches are approved and merged intomain
- Is designed to match the
- Your Personal Development Store
- Is where
feature
andbugfix
tasks should be worked on.
- Is where
main
/ genesis.mivareadythemes.com¶
Purpose¶
Production version of Genesis used to demonstrate its features for POs, clients, and the public.
This store will primarily only be updated by the lead-contributors
Use¶
The store should replicate the main
branch as much as possible.
Update it after release
& hotfix
branch pull-requests have been approved & merged into main
.
FTP Access Setup¶
Unlike the dts-store and our client stores, this server requires the use a of an SSH key to connect to the server through SFTP.
The following steps describe how to generate an SSH key, add it to Plesk, and connect to SFNT through FileZilla with your SSH key so you can upload/download files & pre-provide into the store.
1. Generate an SSH Key¶
Windows
- Download and install PuttyGen
- Launch PuttyGen
- Click the "Generate" button
- Move your mouse around over the dedicated area to generate randomness until the progress bar is full
- Update the "Key Comment" with your first-name-initial + last-name (ex. Change the "Key Comment" from
rsa-key-20200602
toYOURNAME
) - Enter the "Key Passphrase" & "Confirm passphrase"
- Click the "Save Private Key" button and save it to a safe location on your computer (ex.
C:\Users\YOURNAME\Documents\SSH Keys\genesis_rsa.ppk
) - In the Putty Key Generator window, select-all of the contents of the "Public key for pasting into OpenSSH authorized_keys file:" text & copy it.
Mac
- Open Terminal
- cd to
~/.ssh
- Generate a key with the following command:
ssh-keygen -t rsa
- Save the file as
genesis_rsa
- Enter your passphrase
- This will create two files with your ssh folder.
genesis_rsa
andgenesis_rsa.pub
. The.pub
file is your public key and the extension-less file is your private key. - Copy the contents of your pub file:
pbcopy < genesis_rsa.pub
2. Add the Public Key to Plesk¶
- Open the store in Plesk
- In Plesk, navigate to "Domains > genesis.mivareadythemes.com"
- Click on "SSH Keys" in the right column.
- Click the "Add Key" button.
- Paste your public-key
- Click the "Add" button.
3. Connect to Server w/ SSH¶
FileZilla
- Open FileZilla
- Create a new site/connection (ex. "File > Site Manager > New Site")
- Set the "Protocol" to "SFTP"
- Set the "Host" to
216.188.132.238
- Set the "Logon Type" to "Key file"
- Set the "User Name" to
genesis
- Set the "Key file" by browsing to the private-key file you created in Step 1 (ex.
C:\Users\YOURNAME\Documents\SSH Keys\genesis_rsa.ppk
or~/.ssh/genesis_rsa
) - Click "Connect"
- You will be prompted to enter the "Passphrase" you entered in Step 1. Enter it and click "Ok"
- That's it. You should be connected.
Other
- Consult documentation of your preferred FTP/SSH client.
develop
/ genesis.mivamerchantdev.com¶
Purpose¶
A staging environment for Genesis used to run integration tests and exemplify the next release of Genesis.
Use¶
The store should replicate the develop
branch as much as possible.
Update it after bugfix
& feature
branch pull-requests have been approved & merged into develop
.
FTP Access¶
feature
& bugfix
/ Your Dev Store¶
Please do all development work on your own dev store. After the change has been approved & merged into develop
or main
you can then apply the changes to the corresponding store.