Getting started

From Archivematica
(Difference between revisions)
Jump to: navigation, search
(Ansible & Vagrant)
(Ansible & Vagrant: Change branch, re-provisioning)
Line 45: Line 45:
 
# Checkout deployment repo
 
# Checkout deployment repo
 
#* <code>git clone https://github.com/artefactual/deploy-pub.git</code>
 
#* <code>git clone https://github.com/artefactual/deploy-pub.git</code>
 +
#* <code>cd deploy-pub</code>
 
# Temporary: switch to playbooks/archivematica branch
 
# Temporary: switch to playbooks/archivematica branch
 
#* <code>git checkout playbooks/archivematica</code>
 
#* <code>git checkout playbooks/archivematica</code>
#* <code>cd deploy-pub/playbooks/archivematica/</code>
+
#* <code>cd playbooks/archivematica/</code>
 
# Install VirtualBox, Vagrant, Ansible
 
# Install VirtualBox, Vagrant, Ansible
 
#* <code>sudo apt-get install virtualbox vagrant</code>
 
#* <code>sudo apt-get install virtualbox vagrant</code>
Line 55: Line 56:
 
# Download Ansible roles
 
# Download Ansible roles
 
#* <code>ansible-galaxy install -f -r requirements.yml</code>
 
#* <code>ansible-galaxy install -f -r requirements.yml</code>
 +
# (Optional) Change the branch by modifying <code>vars-singlenode.yml</code>
 +
#* <code>amdev_version: "remotes/origin/branch-name"</code>
 +
#* <code>ssdev_version: "remotes/origin/branch-name"</code>
 
# Create virtual machine and provision it
 
# Create virtual machine and provision it
 
#* <code>vagrant up</code> (it takes a while)
 
#* <code>vagrant up</code> (it takes a while)
Line 62: Line 66:
 
#* Archivematica - http://192.168.168.192
 
#* Archivematica - http://192.168.168.192
 
#* Archivematica Storage Service: http://192.168.168.192:8000 (user: test, pass: test)
 
#* Archivematica Storage Service: http://192.168.168.192:8000 (user: test, pass: test)
 +
# Provisioning (via ansible) can be re-run
 +
#* <code>vagrant provision</code>
  
 
=== Development Machine ===
 
=== Development Machine ===

Revision as of 14:40, 18 September 2015

Main Page > Development > Getting Started

This wiki page describes getting started with Archivematica as a developer. For user and administrative manuals, please see http://www.archivematica.org.

Contents

Vital Stats

Projects

Archivematica consists of several projects working together.

  • Archivematica: Main repository containing the user-facing dashboard, task manager MCPServer and clients scripts for the MCPClient
  • Storage Service: Responsible for moving files to Archivematica for processing, and from Archivematica into storage
  • Format Policy Registry: Submodule shared between Archivematica and the Format Policy Registry (FPR) server that displays and updates FPR rules and commands

There are also several smaller repositories that support Archivematica in various ways. In general, you will not need these to develop on Archivematica.

Installation

There are two main ways to run Archivematica in development.

  1. Use ansible and vagrant to install Archivematica in a VM
  2. Install Archivematica on your development machine

Ansible & Vagrant

To install and run Archivematica from source on a VM:

  1. Checkout deployment repo
  2. Temporary: switch to playbooks/archivematica branch
    • git checkout playbooks/archivematica
    • cd playbooks/archivematica/
  3. Install VirtualBox, Vagrant, Ansible
    • sudo apt-get install virtualbox vagrant
    • Vagrant must be at least 1.5 (it can also be downloaded from vagrantup.com)
      • vagrant --version
    • sudo pip install -U ansible
  4. Download Ansible roles
    • ansible-galaxy install -f -r requirements.yml
  5. (Optional) Change the branch by modifying vars-singlenode.yml
    • amdev_version: "remotes/origin/branch-name"
    • ssdev_version: "remotes/origin/branch-name"
  6. Create virtual machine and provision it
    • vagrant up (it takes a while)
  7. Login now available via:
    • vagrant ssh
  8. Services available:
  9. Provisioning (via ansible) can be re-run
    • vagrant provision

Development Machine

See development environment setup instructions

Tests

Archivematica and the related projects have a small but growing test suite. We use py.test to run our tests, which should be listed as a requirement in the development/local requirements file.

To run the tests, go to the repository root and run py.test

See below for project-specific setup or changes to running the tests.

Archivematica

Before running Archivematica tests, set the following environment variables.

#!/usr/bin/fish
set -xg DJANGO_SETTINGS_MODULE 'settings.local'
set -xg DJANGO_SECRET_KEY 'ADDKEY'
set -xg PYTHONPATH /usr/share/archivematica/dashboard/ /usr/lib/archivematica/archivematicaCommon/

#!/usr/bin/bash
export DJANGO_SETTINGS_MODULE='settings.local'
export DJANGO_SECRET_KEY='ADDKEY'
export PYTHONPATH=$PYTHONPATH:/usr/share/archivematica/dashboard/:/usr/lib/archivematica/archivematicaCommon/

Storage Service

Before running Storage Service tests, set the following environment variables

#!/usr/bin/fish
set -xg DJANGO_SETTINGS_MODULE storage_service.settings.local
set -xg DJANGO_SECRET_KEY 'ADDKEY'
set -xg SS_DB_NAME 'storage_service/default.db'
set -xg SS_DB_USER ''
set -xg SS_DB_PASSWORD ''
set -xg SS_DB_HOST ''
set -xg PYTHONPATH .  # The repository root

#!/usr/bin/bash
export DJANGO_SETTINGS_MODULE=storage_service.settings.local
export DJANGO_SECRET_KEY='ADDKEY'
export SS_DB_NAME='storage_service/default.db'
export SS_DB_USER=''
export SS_DB_PASSWORD=''
export SS_DB_HOST=''
export PYTHONPATH=.  # The repository root

Run tests from the storage_service subdirectory.

Skip known-failing test with py.test --ignore locations/tests/test_models.py

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox