Skip to content
IBM Cloud Foundry manifest for Wiki.js
Shell
Branch: master
Clone or download
seafre and NGPixel Overhaul for Wiki.js 2.x (#1)
* Overhaul for Wiki.js 2.x

* test pass, revert to origin URL
Latest commit 4c53f57 Nov 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.bluemix
wiki Overhaul for Wiki.js 2.x (#1) Nov 19, 2019
.gitignore Initial Import Jul 5, 2018
LICENSE Overhaul for Wiki.js 2.x (#1) Nov 19, 2019
README.md Overhaul for Wiki.js 2.x (#1) Nov 19, 2019
install.sh Overhaul for Wiki.js 2.x (#1) Nov 19, 2019
manifest-vars.yml Overhaul for Wiki.js 2.x (#1) Nov 19, 2019
manifest.yml
package.json Overhaul for Wiki.js 2.x (#1) Nov 19, 2019

README.md

IBM Cloud Foundry public - Wiki.js deployment

This repo is an Open Toolchain definition for IBM Cloud Continuous Delivery, to deploy Wiki.js to IBM Cloud Foundry public.

This deployment assumes you have an IBM Cloud account.

For information about Wiki.js, including detailed installation steps, read the following links:

Automated deployment via IBM Cloud Continuous Delivery

Deploy to IBM Cloud Foundry

Step-by-step guidance if required:

  1. Click Deploy to IBM Cloud, this imports the Open Toolchain deployment template into IBM Cloud Continuous Delivery.
  2. Open Toolchain is imported and is complete when the page loads
    • toolchain.yml is executed first and refers to:
      • deploy.json (Page Layout)
      • locals.yml (Translation files)
      • nls/messages.yml (Text Translations)
      • pipeline.yml (Execution steps)
  3. Select the GitHub repository to clone to, and Cloud Foundry deployment target.
  4. Click "Create" to execute the toolchain, including the build pipeline and IBM Cloud Foundry public
  5. Build pipeline is executed
    • Download the latest Wiki.js release
    • Unpack the latest Wiki.js release
    • Create IBM Cloud services for Cloud Foundry app (i.e. PostgreSQL)
    • Populate Cloud Foundry manifest.yml Environment Variables with Env Var from Open Toolchain input
    • Blue-Green Deploy to Cloud Foundry (i.e. cf push)
  6. Wiki.js is running on IBM Cloud Foundry public

Manual deployment from IBM Cloud CLI

  1. Login to IBM Cloud

ibmcloud login

  1. Target the Resource Group

ibmcloud target -g resource_group

  1. Create new IBM Cloud Foundry public Organization for the RG into a specified Region (edit as required)

ibmcloud account org-create new-cf-org --region us-south

  1. Create new IBM Cloud Foundry public Space in the CF Org for the RG

ibmcloud cf create-space new-cf-space -o new-cf-org

  1. Target the new CF Org and CF Space, and set the domain to be used in connecting to Cloud Foundry. NOTE: Using ibmcloud target --cf will revert to your default domain which may not be preferred for this deployment

ibmcloud target --cf-api api.us-south.cf.cloud.ibm.com -o new-cf-org -s new-cf-space

  1. Create new PostgreSQL service named "db-psql" (edit name as required) in the Resource Group with default basic/low settings

ibmcloud resource service-instance-create db-psql databases-for-postgresql standard us-south

  1. Check the new PostgreSQL service named "db-psql" (edit name as required) is active (takes 5-15mins for production-ready PostgreSQL DB)

ibmcloud resource service-instances

  1. Create service instance alias named "db-psql" for the PostgreSQL service named "db-psql" to be used for binding the to CF App running in the CF Space

ibmcloud resource service-alias-create db-psql --instance-name db-psql

  1. Edit manifest-vars.yml file as required to change deployment names

Specify the Region and PostgreSQL database service instance name

  1. Instantiate the CF App using cf push

ibmcloud cf push --vars-file=manifest-vars.yml

  1. NOTE: In the unlikely event there is an issue with the routing for the CF App after deployment, attempt below (source: https://cloud.ibm.com/docs/cloud-foundry-public?topic=cloud-foundry-public-update-domain)

ibmcloud cf map-route wikijs-cf us-south.cf.appdomain.cloud --hostname wikijs-cf


NOTES:

  • IBM Cloud Resource Groups cannot be deleted
  • Within an IBM Cloud Resource Group, Cloud Foundry Orgs cannot be deleted
  • System Domains used for CF Apps are associated to the Account's default region (e.g accounts from EU would use eu-de.cf.appdomain.cloud, and accounts from US would use us-south.cf.appdomain.cloud)
  • Use the IBM Cloud CLI to list all IBM Cloud Foundry public marketplace services to attach to CF Apps with $ ibmcloud cf marketplace | awk -F' ' '{print $1}'
You can’t perform that action at this time.