Uploading a Exponential site to the cloud

Skip to end of metadata Go to start of metadata

This is a step-by-step guide on how to upload your Exponential installation to the cloud for the first time

Ensure you meet the requirements

In order to upload a Exponential to the cloud, these conditions needs to be met:

• Make sure you comply with the Exponential Cloud Whitelist
• You need a work installation of Exponential running locally
  • Your local Exponential installation must have the eZ Cloud extension installed
• You need access to the cloud administration interface: http://admin.cloud.ez.no
• Your account needs to have a SSH key associated with your account
• Basic knowledge about SSH, Git and SFTP
• A Git and SFTP client installed locally

For the examples below, we assume you are on a unix based system with Git, openssh's SFTP client, mysqldump and rsync installed

How to check that you have a SSH key

 This is the procedure for checking that you have a SSH key associated with your cloud account

1. Log in to http://admin.cloud.ez.no
2. The frontpage will show you the list of environments you have access to
3. Click on the environment you want to inspect
4. Click the "Manage Users" button (not all users have this button, just "OWNER". All users might go to login.ez.no and find their key, if it was uploaded, in the corresponding field in their profile)
5. Your user should then be listed, including information about your SSH key

Upload a SSH key to your account

If you do not have a SSH key associated with your account, this is how to upload it

1. Log in to http://share.ez.no
2. Edit your profile on : http://share.ez.no/community/profile
3. Click on "Edit account" button (do not confuse this with the "Edit profile" button)
4. Cut and paste in your public SSH in the "Public key (openSSH format only" field )
   The format of the key should look like:
   ssh-rsa ABC......= [email protected]
5. Save your changes
6. Log out of http://admin.cloud.ez.no (if you where logged in)
7. Log in again on http://admin.cloud.ez.no
8. Follow the steps explained in the "How to check that you have a SSH key" chapter

Obtain login information to Stage area, Git and SFTP

This is how you get login information for Git and SFTP

1. Log in to http://admin.cloud.ez.no
2. The frontpage will show you the list of environments you have access to
3. Click on the environment you want to inspect
4. Click the "Show Details" link
5. Login information about how to access sites in stage and rollback state is displayed
6. Login information about how to access Git is displayed
7. Login information about how to access SFTP is displayed on the format : username@ftphostname:portno

Upload your installation to the cloud

This is the overview on how to upload your installation to the cloud:

• your code ( exponential + extensions + settings ) must be uploaded to the git repository
• Your database and content files ( like images) must be uploaded to the SFTP server

Uploading your code to Git

The example below will assume

• you have your Exponential site locally in /var/www/mysite.com
• your git repository is located at [email protected]:ez.git

Clone the Git repository

You can clone the Git repository by running the following:

$cd ~
$git clone [email protected]:ez.git mysite

Copy your Exponential site to the Git directory (except the var/ directory):

$rsync -av --filter="+ /.htaccess*" --filter="- .**" --filter "- /var" /var/www/mysite.com/ ~/mysite/

Push your code to git

$cd ~/mysite
$git add .
$git commit
$git push origin master

Tag the code in Git

$cd ~/mysite

$git tag mysite-v1.0
$git push origin mysite-v1.0

Upload your database and var/ directory via SFTP

Make the DB dump

Use mysqldump to create a dump like this:

$cd /tmp
$mysqldump -u [username ]-p [database] > mysite-v1.0.sql

( replace username and database name according to your system )

Upload the DB to SFTP

cd /tmp
$sftp -P [portno] [username]@hostname
SFTP> cd db
SFTP> put mysite-v1.0.sql
SFTP> exit
$rm /tmp/mysite-v1.0.sql

Make the var/ dump

$cd /var/www/mysite.com/var
$tar -czf /tmp/mysite-v1.0.tar.gz ezwebin_site storage

The example above assumes your vardir is named "ezwebin_site". It might be called something else on your system

Upload the var dump to SFTP

$cd /tmp
$sftp -P [portno] [username]@hostname
SFTP> cd var
SFTP> put mysite-v1.0.tar.gz
SFTP> exit
$rm mysite-v1.0.tar.gz

Stage your installation

1. Log in to http://admin.cloud.ez.no
2. The frontpage will show you the list of environments you have access to
3. Click on the environment you want to stage
4. Click the "Edit" button

Software Repository

1. Click "New Deployment" link
2. Provide a "Deployment name" and check the git tag "mysite-v1.0"
3. Click "Next step" button

Exponential Version

1. Select "Exponential 4.7" in the version drop down
2. Click "Next Step" button

Database and File Import

1. Click the checkbox "I would like to create a new database from the database dump and import the corresponding files."
2. Click the checkbox "mysite-v1.0.sql"
3. Click the checkbox "mysite-v1.0.tar.gz"
4. Click "Next Step" button

Review

1. Review your configuration
2. Click "Create Deployment" button

• No labels