mikesprague / lucee5-heroku Goto Github PK

View Code? Open in Web Editor NEW

9.0 4.0 8.0 56.79 MB

Blank application template to deploy Lucee 5 apps on Heroku

License: MIT License

ColdFusion 55.89% CSS 3.14% JavaScript 40.97%

lucee lucee-server java cfml heroku

lucee5-heroku's Introduction

Lucee 5 Application Template for Heroku

NO LONGER MAINTAINED

After the recent Heroku breach (and more than the breach, it was the way comms were handled) I closed my 10+ year old Heroku account. As such, there are no more live demos. I haven't been using Lucee/CFML for several years at this point either so this repo will no longer be maintained.

Credits/Notes

This project is based off of the offical Lucee Heroku Buildpack

Requirements

Maven to build the project
Foreman to run locally

Instructions

To get started, run the following commands in GitBash (or your terminal of preference):

git clone https://github.com/mikesprague/lucee5-heroku.git
cd lucee5-heroku
mvn package
foreman start

NOTE: On Windows, start foreman with the following command:

foreman start -f Procfile.dev

You should now have Lucee up and running at http://localhost:5000. Start adding your code.

To deploy your site to Heroku you need to setup a free Heroku account, install the Heroku toolbelt (Suggested reading: Getting Started with Java on Heroku). Then...

heroku apps:create [NAME]
git push heroku master
heroku open

You should now be looking at your app running on Heroku.

NOTES:

If you need access to the admin, disable the first rule in urlrewrite.xml.
Default password for web admins is password. This should be changed to something secure before deploying your app.
Make any settings (datasources, mail settings, etc.) changes you want locally via the web context, commit your changes and then deploy your app and they will also exist on Heroku.
- Better practice to add any settings changes, datasources, etc. via Application.cfc; use web context for changes if you must set them via Lucee Admin
- Server context will be overwritten on deploy, very important desired changes are made to web context if you wish to keep them
If you get a Heroku application error try reloading the page. This is a known issue. I think the Lucee dependencies aren't quite ready when this happens, I need to look into it further.

Enjoy!

Known Projects Using the Lucee 5 Application Template for Heroku

Have a project making use of this application template? Lem me know and I'll be happy to list it below!

Wheelie CMS developed by Tim Badolato (@timsayshey)
- CFWheels and Lucee powered CMS with one-click Heroku deploy powered by this project
- Check out the project repo for full details: https://github.com/timsayshey/wheelie/

lucee5-heroku's People

Contributors

Stargazers

Watchers

Forkers

yunic-nl timsayshey nathanleg rwatts3 sgml dreamstarter brendonha3 matthewjones

lucee5-heroku's Issues

Run COldBox app

I'm trying to setup a simple ColdBox app.

I successfully installed lucee.

If I try to run a ColdBox app I got this error:

invalid component definition, can't find component [coldbox.system.Bootstrap]
--
Stacktrace | The Error Occurred in
/app/webroot/Application.cfc: line 24
22: // application start
23: public boolean function onApplicationStart(){
24: application.cbBootstrap = new coldbox.system.Bootstrap( COLDBOX_CONFIG_FILE, COLDBOX_APP_ROOT_PATH, COLDBOX_APP_KEY, COLDBOX_APP_MAPPING );
25: application.cbBootstrap.loadColdbox();
26: return true;

I must add some mapping configuration?

data source on web admin throws and error

Occasional application error if Heroku instance has been asleep

🔄 Reloading the page in the browser allows the app to load properly and the error goes away.

Need to check Heroku logs and research further to determine if there's anything I can on my end to prevent this.

How to set up admin password?

If I try to access to /lucee/admin/server.cfm?action=overview

I seee this message:

For security reasons it is no longer possible to set the inital password here directly.
You will need to configure a password before you can access the Server Administrator.
create a file with name password.txt containing your new password under the root Lucee server directory ( /lucee-server/context/password.txt ).
click "import file", Lucee will then read and configure your new password, afterwards Lucee will automatically delete that file

How can I upload the password.txt? Where should I put it?

No datasources!

Hi - there are no datasource types available in this build. Not even 'other'
thanks

data source on web admin throws and error

Hi,

When i installed it, everything went fine but going to the data source section between server and web throws an error, I can still get the data source in the server section but web errors out.

One other question I did have is, would it be possible to expand a little on the deployment side? When i try and deploy out it overwrites the settings each time, like its deploying a new instance of Lucee each time.

Thanks!

Deploy Lucee Config

Is there a way to deploy to heroku with Lucee settings included? ie, lucee-server.xml and lucee-web.xml.cfm

This is important because everytime I deploy all of my settings are lost and I have to set a password and reconfigure lucee.

Any suggestions?