Description

This is a Heat template to deploy multiple Linux server running Magento Community Edition.

Requirements

A Heat provider that supports the following:
- OS::Heat::ChefSolo
- OS::Heat::RandomString
- Rackspace::Cloud::LoadBalancer
- OS::Heat::ResourceGroup
- Rackspace::Cloud::Server
- OS::Nova::KeyPair
An OpenStack username, password, and tenant id.
python-heatclient >= v0.2.8:

pip install python-heatclient

We recommend installing the client within a Python virtual environment.

Parameters

Parameters can be replaced with your own values when standing up a stack. Use the -P flag to specify a custom parameter.

database_hostname: Hostname to use for the server that is built. (Default: Magento-Database)
username: Username for the Magento Administrative user account. (Default: MagentoAdmin)
domain: Domain to be used with the Magento store (Default: example.com)
last_name: Last name of the Admin user (Default: last)
db_flavor: Required: Rackspace Cloud Server flavor to use. The size is based on the amount of RAM for the provisioned server. (Default: 4 GB Performance)
image: Required: Server image used for all servers that are created as a part of this deployment. (Default: Ubuntu 12.04 LTS (Precise Pangolin))
web_server_count: Required: Number of web servers to deploy in addition to the master server. (Default: 1)
load_balancer_hostname: Hostname to use for the Load Balancer that is built. (Default: Magento-Load-Balancer)
install_sample_data: If selected, this will install Magento sample data. This can be useful for development purposes. (Default: False)
database_user: Magento Database Username (Default: magentouser)
kitchen: URL for a git repo containing required cookbooks (Default: https://github.com/rackspace-orchestration-templates/magento-multi)
web_server_flavor: Required: Rackspace Cloud Server flavor to use. The size is based on the amount of RAM for the provisioned server. (Default: 2 GB Performance)
master_flavor: Required: Rackspace Cloud Server flavor to use. The size is based on the amount of RAM for the provisioned server. We recommend the master server be one size larger than the web nodes as it handles admin calls and content syncing. (Default: 4 GB Performance)
database_name: Magento database name (Default: magento)
master_hostname: Hostname to use for the server that is built. (Default: Magento-Master)
web_hostname: Hostname to use for the server that is built. (Default: Magento-Web%index%)
child_template: Location of the child template to use for the Magento web servers (Default: https://raw.githubusercontent.com/rackspace-orchestration-templates/magento-multi/master/magento-web-server.yaml)
first_name: First name of the Admin user (Default: first)
admin_email: Email address to associate with the Magento admin account. (Default: admin@example.com)
chef_version: Version of chef client to use (Default: 11.14.2)

Outputs

Once a stack comes online, use heat output-list to see all available outputs. Use heat output-show <OUTPUT NAME> to get the value of a specific output.

private_key: SSH Private Key
load_balancer_ip: Load Balancer IP
admin_password: Admin Password
admin_user: Admin User
mysql_root_password: MySQL Root Password
admin_url: Admin URL
magento_url: Store URL

For multi-line values, the response will come in an escaped form. To get rid of the escapes, use echo -e '<STRING>' > file.txt. For vim users, a substitution can be done within a file using %s/\\n/\r/g.

Stack Details

Getting Started

If you're new to Magento Community Edition, the Magento User Guide will step you through the process of configuring and managing your store. This guide is free, but does require you to provide a valid email address to receive it.

The Magento Forum provides a place to get answers to both simple and advanced questions regarding configuration and management of Magento Community Edition.

Logging into Magento

To login, go to the URL listed above in a browser. If your DNS is not pointing to this installation, you can add a line in your hosts file to point your domain to the IP of this Cloud Server. Once you've done this, restart your browser and navigate to the site. The backend can be accessed by adding '/admin' to the end of the URL, and you can login with the credentials provided above.

Logging in via SSH

The private key provided in the passwords section can be used to login as root via SSH. We have an article on how to use these keys with Mac OS X and Linux as well as Windows using PuTTY.

Details of Your Setup

This deployment was stood up using chef-solo. Once the deployment is up, chef will not run again, so it is safe to modify configurations.

A system user named 'magento' has been created. This user does not have a password set, so if you wish to use the account, a password will need to be set. This account is the system user for PHP-FPM, so deletion of this user will take eCommerce site down.

Nginx is used as the web server and listens on port 80 and 443 to handle web traffic. The configuration for your site can be found in /etc/nginx/sites-enabled. There will be a default site configuration, and a seperate one for SSL traffic. Magento itself is installed in /var/www/vhosts. You will find a directory with the name of website you entered as a part of this deployment. The SSL certificates used are self signed and were generated when this deployment was created. You can replace the private key and certificate by overwriting the ones in /etc/nginx/ssl.

PHP-FPM is used to handle evaluation of all PHP-based pages. The configuration for this installation is in /etc/php5/fpm/pools/magento.conf. By default, PHP-FPM is running as the 'magento' user, listens on port 9001.

Object and session caching are handled by Memcached. Memcache helps performance by storing data in memory for faster responses to clients. These caches help lessen the number of queries required to the database. There are two seperate instances of Memcached running to ensure session and object caching are handled seperately. The session cache is listening on port 11211, and is set as a 512MB cache. The object cache is listening on port 11212, and it is set as a 1.5GB cache. The configuration files are memcached_sessions.conf and memcached_backend.conf in /etc on the database server.

MySQL 5.5 is installed as the database backend. All configuration with Magento has been handled as a part of the setup. The MySQL root password is provided as a part of this deployment. If you lose or forget the password, it can also be found in /root/.my.cnf.

MySQL backups are performed nightly by Holland. Backups can be found in /var/lib/mysqlbackup on the Database server

Magento Plugins

There are thousands of plugins that have been developed for Magento by the developer community. Magento Connect provides an easy way to discover popular plugins that other users have found to be helpful. Not all plugins are free, and we recommend only installing the plugins that you need.

Additional Notes

There is not an automatic way to add additional nodes to this deployment. This deployment is meant for lower traffic or testing scenarios.

Contributing

There are substantial changes still happening within the OpenStack Heat project. Template contribution guidelines will be drafted in the near future.

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Brandon168/magento-multi