Operation of data.gov.uk
Download and install Cloud Foundry CLI
Sign into the PaaS. You will be prompted for your username and password. After authenticating, a list of your accessible spaces will be shown, select
cf login -a api.cloud.service.gov.uk
Don’t have an account? If you don’t have an account or if your account isn’t recognised ask on #govuk-2ndline for an account.
- SSH into the relevant machine, e.g.
cf ssh publish-data-beta-production-worker
There are detailed instructions in the PaaS documentation.
Accessing a Rails Console
The following can be used on any PaaS machine to access a Rails console. The example is for the Find production instance.
cf ssh find-data-beta /tmp/lifecycle/launcher /home/vcap/app 'rails console' ''
This is done using the
search:reindex rake task in Publish and will not cause any app downtime.
cf ssh publish-data-beta-staging /tmp/lifecycle/launcher /home/vcap/app 'rails search:reindex' ''
This will populate a new index and rotate the
dataset-staging alias to point to it when it’s ready.
Perform a full re-sync from CKAN
The sync is normally done automatically using Sidekiq Scheduler. There may be times when you need to throw away the existing Postgres database, sync all datasets from CKAN and reindex.
This will not make any changes to the content on Find until the reindex has completed and the Elastic index is updated. This will affect data served on Publish, however this service is not currently used for publishing or editing datasets. In most cases, you should never need to do this as the sync performs incremental updates.
### connect to staging cf ssh publish-data-beta-staging ### connect to production cf ssh publish-data-beta-production ## make sure the database is empty /tmp/lifecycle/launcher /home/vcap/app 'rails db:drop db:setup' '' ## make sure the index is setup /tmp/lifecycle/launcher /home/vcap/app 'rails search:reindex' '' ## sync datasets or update orgs /tmp/lifecycle/launcher /home/vcap/app 'rails runner CKAN::V26::PackageSyncWorker.new.perform' '' /tmp/lifecycle/launcher /home/vcap/app 'rails runner CKAN::V26::CKANOrgSyncWorker.new.perform' ''
bundle exec sidekiq and
rails s and monitor the resulting jobs in the Sidekiq Web UI.
You will need to arrange with 2nd line for your public SSH key to be added to the Bytemark production server. Once this is done, you can connect by SSH with the username
When working on co-prod3, you must pair because we don’t have a robust development environment for the current CKAN configuration.