Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: custom bundle dev

...

See Setting up a local Git repository to get started with your standard bundle development workflow.

...

Custom cloud bundle development workflow

In the case of custom cloud bundle implementations, the development workflow is different. You or your cloud partner create the Magnolia bundle that is deployed to the cloud. 

From Magnolia 6.2.1, Magnolia provides a cloud-specific option in the Magnolia Maven Archetype to facilitate the creation of your cloud bundles.

The Magnolia Maven Archetype generates a best-practice project skeleton. The Magnolia Cloud Maven Plugin validates and uploads your custom cloud bundle.

Code Block
my-mgnl-cloud-webapp/
├── pom.xml
└── src
    └── main
        └── webapp
            └── WEB-INF
                └── config
                    └── dev
                    │   └── README.md
                    │   └── magnolia.properties
                    └── shared
                        └── README.md
                        └── magnolia.properties

Note:

  • Two default profiles are generated: dev and shared. These profiles have their own magnolia.properties files. 
  • During packaging, the dev profile is excluded. The shared profile is included and deployed to Magnolia Cloud.
  • You can add local developer credentials to the dev profile to be used instead of the typical Magnolia superuser/superuser, which is disabled in the cloud.
  • In the shared profile, you can create specific .properties files for each cloud environment. This can be used, for example, to test the integration of a third-party tool in the UAT environment without affecting your Live environment. 

Make sure you use the latest version of the Magnolia Cloud Maven Plugin when deploying a new bundle to Magnolia Cloud: v1.0-RC6 (available soon)

More information can be found in the readme here: https://git.magnolia-cms.com/projects/OD/repos/magnolia-cloud-maven-plugin/browse/README.md

Warning

If you previously created a custom bundle with .properties file changes, please check your customizations carefully and adhere to the structure shown above.

Once your custom bundle is deployed to the cloud, you can work with Magnolia Cloud as described above for any light development. For java development customizations, the custom bundle deployment process must be followed.

Hands-on learning

Try out our end-to-end Hello-cloud development tutorial, in which you set up a light module and deploy it in Magnolia.

...