mirror of
https://github.com/dathere/ckan-devstaller.git
synced 2025-11-09 13:39:49 +00:00
feat(docs): update quick start page and add reference section
This commit is contained in:
parent
cbd0a6dfd9
commit
b984c3b5e0
12 changed files with 435 additions and 4 deletions
|
|
@ -3,4 +3,64 @@ title: Quick Start
|
|||
description: Getting Started with ckan-devstaller
|
||||
---
|
||||
|
||||
This site is a work in progress. You may [view the ckan-devstaller README and source code](https://github.com/dathere/ckan-devstaller) in the meantime.
|
||||
ckan-devstaller attempts to install a CKAN instance from source along with [ckan-compose](https://github.com/tino097/ckan-compose) and other optional features, intended for development use in a new Ubuntu 22.04 instance.
|
||||
|
||||
<Callout title="Please run ckan-devstaller in a new Ubuntu 22.04 instance only" type="error">Make sure `ckan-devstaller` is run in a **new** Ubuntu 22.04 instanceof. Do NOT run `ckan-devstaller` in an existing instance that is important for your usage.</Callout>
|
||||
|
||||
import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
|
||||
|
||||
<Accordions type="single">
|
||||
<Accordion title="Note for VirtualBox users">If you are using Ubuntu 22.04 on VirtualBox, you may need to add your user to the sudoers file before running the ckan-devstaller install script. Open a terminal in your virtual machine (VM), run `su -` and log in as the root user with the password you used to set up the VM, then type `sudo adduser <username> sudo` where `<username>` is your username then restart your VM and run the ckan-devstaller installer script.</Accordion>
|
||||
<Accordion title="Note for ARM64 users">Currently `ckan-devstaller` supports `x86_64` architecture. `ARM64` support is planned.</Accordion>
|
||||
</Accordions>
|
||||
|
||||
Currently you have two options to choose from for installation. Paste one of the following scripts into your new Ubuntu 22.04 instance's terminal:
|
||||
|
||||
## (Option 1/2) Install with interactive mode
|
||||
|
||||
```bash
|
||||
wget -O - https://github.com/dathere/ckan-devstaller/releases/download/0.2.1/install.bash | bash -s default
|
||||
```
|
||||
|
||||
## (Option 2/2) Install with non-interactive mode with a specific config
|
||||
|
||||
The following script will install the following:
|
||||
|
||||
- CKAN 2.11.3
|
||||
- [ckan-compose](https://github.com/tino097/ckan-compose/tree/ckan-devstaller)
|
||||
- [DataStore extension](https://docs.ckan.org/en/2.11/maintaining/datastore.html)
|
||||
- [ckanext-scheming extension](https://github.com/ckan/ckanext-scheming)
|
||||
- [DataPusher+ extension](https://github.com/dathere/datapusher-plus)
|
||||
|
||||
[DRUF mode](https://github.com/dathere/datapusher-plus?tab=readme-ov-file#druf-dataset-resource-upload-first-workflow) for DataPusher+ is available but disabled by default.
|
||||
|
||||
```bash
|
||||
wget -O - https://github.com/dathere/ckan-devstaller/releases/download/0.2.1/install.bash | bash -s default
|
||||
```
|
||||
|
||||
## Learn more
|
||||
|
||||
import { BlocksIcon, GitMergeIcon, Trash2Icon } from 'lucide-react';
|
||||
|
||||
<Cards>
|
||||
<Card
|
||||
icon={<GitMergeIcon />}
|
||||
href="https://github.com/dathere/ckan-devstaller"
|
||||
title="Source code">
|
||||
View the source code of ckan-devstaller on GitHub
|
||||
</Card>
|
||||
<Card
|
||||
icon={<BlocksIcon />}
|
||||
href="/docs/reference/installation-architecture"
|
||||
title="Installation architecture"
|
||||
>
|
||||
Learn about where files are installed after running ckan-devstaller
|
||||
</Card>
|
||||
<Card
|
||||
icon={<Trash2Icon />}
|
||||
href="/docs/tutorials/uninstall-ckan"
|
||||
title="Uninstall CKAN"
|
||||
>
|
||||
Learn how to uninstall CKAN after running ckan-devstaller
|
||||
</Card>
|
||||
</Cards>
|
||||
|
|
|
|||
76
docs/content/docs/reference/installation-architecture.mdx
Normal file
76
docs/content/docs/reference/installation-architecture.mdx
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
---
|
||||
title: Installation architecture
|
||||
description: View a brief overview of what the installation from ckan-devstaller looks like
|
||||
---
|
||||
|
||||
import { File, Folder, Files } from 'fumadocs-ui/components/files';
|
||||
|
||||
## CKAN and extensions
|
||||
|
||||
The CKAN repository selected from ckan-devstaller is installed to `/usr/lib/ckan/default/src/ckan`. Extensions are also installed as sibling folders. For example if `ckanext-scheming` is also installed:
|
||||
|
||||
```files
|
||||
/usr/lib/ckan/default/src
|
||||
├── ckan
|
||||
│ ├── ...
|
||||
├── ckanext-scheming
|
||||
│ ├── ...
|
||||
```
|
||||
|
||||
The configuration file for CKAN is installed at `/etc/ckan/default/ckan.ini`:
|
||||
|
||||
```files
|
||||
/etc/ckan/default
|
||||
├── ckan.ini
|
||||
├── who.ini
|
||||
```
|
||||
|
||||
## ckan-compose
|
||||
|
||||
We install certain first-time install files and `ckan-compose` as a directory in the user's home (`~`) directory. For example for the user `adam`:
|
||||
|
||||
```files
|
||||
/home/adam
|
||||
├── ahoy
|
||||
├── dpp_default_config.ini
|
||||
├── get-docker.sh
|
||||
├── permissions.sql
|
||||
├── ckan-compose
|
||||
│ ├── ...
|
||||
```
|
||||
|
||||
After running ckan-devstaller you may also see many files starting with `qsv` and `README`. There are various files you can remove after running ckan-devstaller including:
|
||||
|
||||
- `dpp_default_config.ini`
|
||||
- `get-docker.sh`
|
||||
- `permissions.sql`
|
||||
- `README`
|
||||
- The various `qsv` files
|
||||
|
||||
Here's a script you can run for cleanup after running ckan-devstaller:
|
||||
|
||||
```bash
|
||||
cd ~/
|
||||
rm -rf dpp_default_config.ini get-docker.sh permissions.sql README qsv*
|
||||
```
|
||||
|
||||
## DataPusher+
|
||||
|
||||
We install a compatible version of qsv with the DataPusher+ variant named `qsvdp` and move it to `/usr/local/bin`:
|
||||
|
||||
```files
|
||||
/usr/local/bin
|
||||
├── qsvdp
|
||||
```
|
||||
|
||||
The ckanext-scheming and DataPusher+ extensions are installed in the same location as other CKAN extensions:
|
||||
|
||||
```files
|
||||
/usr/lib/ckan/default/src
|
||||
├── ckan
|
||||
| ├── ...
|
||||
├── ckanext-scheming
|
||||
| ├── ...
|
||||
├── datapusher_plus
|
||||
| ├── ...
|
||||
```
|
||||
Loading…
Add table
Add a link
Reference in a new issue